Sobre a API U2D Pay
Receba por Pix, cartão e boleto com uma única integração REST.
A API U2D Pay é a forma de criar e acompanhar cobranças da U2D Pay a partir do seu sistema. Uma integração REST, autenticada por OAuth 2.0, dá acesso a Pix, cartão de crédito e débito e boleto. Você não precisa saber qual provedor de pagamento atende cada cobrança: o contrato é o mesmo para todas.
Primeiros passos
Do token à primeira cobrança Pix em poucos minutos.
Referência da API
Todos os endpoints, parâmetros e respostas.
Autenticação
Client credentials, escopos e validade do token.
Novidades
O que mudou na API e no portal.
O que a API oferece
- Cobranças avulsas em Pix, cartão de crédito, cartão de débito e boleto, ou com a forma de pagamento escolhida pelo pagador.
- Checkout U2D: uma página de pagamento pronta para enviar ao pagador, com QR Code e Pix copia-e-cola.
- Consulta de cobranças com filtros por status, forma de pagamento, pagador e período, paginada.
- Idempotência em toda criação: um retry nunca cobra duas vezes.
Garantias da plataforma
| Garantia | Como funciona |
|---|---|
| Segurança | OAuth 2.0 (client credentials) com tokens de 5 minutos, TLS em toda chamada. Dados de cartão nunca passam pela U2D: o pagador digita na página do provedor. |
| Idempotência | Idempotency-Key obrigatório em POST: a mesma chave devolve a mesma resposta por 24 horas. Veja Idempotência. |
| Rastreabilidade | Toda resposta traz o header X-Request-Id. Informe-o no Atendimento para localizarmos a chamada. |
| Erros padronizados | Todo erro sai no formato Problem Details (RFC 9457, sucessora da RFC 7807), com a lista de campos inválidos. |
| Limite de uso | 30 requisições por minuto por client, com 429 e Retry-After ao exceder. Veja Rate limit. |
URL base
Todas as chamadas vão para o gateway da U2D Pay:
https://api.u2dpay.com.brO status de cada ambiente pode ser conferido a qualquer momento no botão API Status, no topo da página.