O checkout transparente gera um PIX que o cliente paga sem sair do seu site ou app.
Receber via PIX
Use /transparents/create. A API devolve o QR Code em imagem (brCodeBase64) e o código copia e cola (brCode).
Campos obrigatórios
Só data.amount é obrigatório (valor em centavos). O campo method hoje é sempre "PIX".
Exemplo de requisição:
POST /transparents/create
{
"method": "PIX",
"data": {
"amount": 10000,
"description": "Cobrança PIX no checkout transparente",
"expiresIn": 3600,
"customer": {
"name": "Daniel Lima",
"email": "daniel_lima@abacatepay.com",
"taxId": "123.456.789-01",
"cellphone": "(11) 4002-8922"
},
"metadata": {
"pedidoId": "pedido-123"
}
}
}
Exemplo de resposta:
{
"data": {
"id": "pix_char_abc123xyz",
"amount": 10000,
"status": "PENDING",
"devMode": false,
"brCode": "00020160014BR.GOV.BCB.PIX070503***6304ABCD",
"brCodeBase64": "data:image/png;base64,iVBORw0KG...",
"platformFee": 100,
"createdAt": "2024-11-04T18:38:28.573Z",
"updatedAt": "2024-11-04T18:38:28.573Z",
"expiresAt": "2024-11-04T19:38:28.573Z",
"metadata": {
"pedidoId": "pedido-123"
}
},
"success": true,
"error": null
}
Use brCodeBase64 para exibir a imagem do QR Code ou brCode (copia e cola) para enviar por WhatsApp/Telegram ou integrar no seu checkout.
Ideias de uso
- WhatsApp/Telegram: envie o QR Code ou o código copia e cola na conversa.
- Checkout próprio: exiba o PIX na sua página e mantenha o cliente no seu site.