Introdução
Documentação técnica para integradores da plataforma de pagamentos da Eagle
Bem-vindo à documentação técnica da Eagle. A plataforma tem duas frentes: a API de Pagamentos, com três modalidades — cartão, link de pagamento e Pix — sob a mesma autenticação, e o SDK SoftPOS, para cobrar por aproximação no celular do vendedor.
URL base
| Ambiente | URL base |
|---|---|
| Sandbox | https://api.sandbox.eagleix.com.br |
Todos os caminhos de endpoint desta documentação (ex.: POST /api/v1/pix-charges) são
relativos à URL base.
Como as peças se encaixam
No pagamento remoto, sua aplicação fala apenas com a API de Pagamentos, autenticada por mTLS (certificado cliente fornecido pela EagleIX). A comunicação com adquirentes, autorizadores, bandeiras e o sistema Pix fica encapsulada na API.
Modalidades
| Modalidade | O que faz |
|---|---|
| Cartão | Autoriza, consulta e cancela pagamentos com cartão. Usa tokenização para não trafegar o número real |
| Link de pagamento | Gera uma URL de cobrança que aceita PIX ou cartão |
| Pix | Gera cobranças com QR Code dinâmico, devolve valores e notifica por webhook |
Pagamento presencial
Para cobrar cara a cara, o SDK SoftPOS transforma o celular Android do vendedor em terminal de pagamento por aproximação. A integração é diferente da API REST: o app embarca o SDK, que orquestra o aplicativo m-SiTef da Fiserv. Há wrappers para React Native e Flutter.
Por onde começar
- Autentique suas requisições — envie o certificado cliente (mTLS) fornecido pela EagleIX em toda requisição
- Escolha a modalidade — cartão, link de pagamento ou Pix
- Cartão — tokenize o cartão e crie o pagamento com o token
- Link de pagamento — gere o link e envie ao pagador
- Pix — emita a cobrança com QR Code e acompanhe o pagamento pelo webhook
- SoftPOS — para cobrança presencial, integre o SDK ao app Android do vendedor (não usa mTLS; ver requisitos)
Documentação
Autenticação
Envie o certificado cliente (mTLS) em todas as requisições
Cartão · Pagamentos
Crie, consulte e cancele transações com cartão
Cartão · Tokenização
Tokenize, consulte e habilite/desabilite cartões
Link de Pagamento
Gere e gerencie links de cobrança
Pix
Crie cobranças com QR Code, devolva valores e configure o webhook
SoftPOS · Tap on Phone
SDK Android, React Native e Flutter para cobrar por aproximação