Primeiros passos
Do token de acesso à primeira cobrança Pix.
Este guia leva você da credencial à primeira cobrança Pix, com curl. Os mesmos passos valem para
qualquer linguagem com cliente HTTP.
Receba suas credenciais
O time da U2D Pay entrega, por canal seguro, um client id e um client secret do seu sistema. Eles identificam a sua empresa (o lojista) em toda chamada. Guarde o secret como senha: nunca no código-fonte, no front-end ou em e-mail. Ainda não tem credenciais? Fale com a gente pelo Atendimento.
Gere um access token
Troque as credenciais por um token no servidor de autorização (OAuth 2.0, client credentials):
curl -s https://auth.u2dtecnologia.com.br/realms/u2d-pay/protocol/openid-connect/token \
-u "$CLIENT_ID:$CLIENT_SECRET" \
-d grant_type=client_credentials{
"access_token": "eyJhbGciOiJFUzI1NiIs...",
"expires_in": 300,
"token_type": "Bearer"
}O token vale 5 minutos. Reaproveite-o enquanto valer e peça outro perto de expirar; não peça um token por chamada. Detalhes em Autenticação.
Crie uma cobrança Pix
Envie o token no header Authorization e uma chave única no Idempotency-Key (um UUID novo por
cobrança):
curl -s https://api.u2dpay.com.br/payments \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Idempotency-Key: 6f1c2a9e-3b7d-4c1e-9a2f-5d8e7b6c4a10" \
-H "Content-Type: application/json" \
-d '{
"payer": { "name": "Maria Silva", "document": "12345678909", "email": "maria@example.com" },
"amount": 49.90,
"dueDate": "2030-01-15",
"billingType": "PIX",
"description": "Pedido 1234"
}'A resposta é 201 Created com a cobrança:
{
"id": "0b6f7c1e-2d4a-4f8b-9c3e-1a5d7e9f2b40",
"status": "PENDING",
"billingType": "PIX",
"amount": 49.90,
"dueDate": "2030-01-15",
"description": "Pedido 1234",
"checkoutUrl": "https://checkout.u2dpay.com.br/c/Xb3kq9Lr2Vw8Yt5Nc1Hp7Jd4Fs6Gm0Az2Qe9Wu3Ri5O",
"invoiceUrl": "https://...",
"fee": 0.74,
"pix": {
"copyPaste": "00020101021226...",
"expiresAt": "2030-01-15T02:59:59Z"
},
"createdAt": "2030-01-14T13:02:11.512Z"
}Entregue a cobrança ao pagador
Envie o checkoutUrl ao pagador (WhatsApp, e-mail, botão no seu app): é a página de pagamento da U2D,
com QR Code e Pix copia-e-cola, que mostra a confirmação assim que o pagamento cai. Se preferir montar a sua
própria tela, use pix.copyPaste para gerar o QR Code. Veja Checkout U2D.
Acompanhe o pagamento
Consulte a cobrança pela listagem até o status chegar em RECEIVED (Pix pago)
ou CANCELED/OVERDUE. Os status estão em Cobranças.