O endpoint POST /v1/pix/in/qrcode cria uma transação PIX e retorna o emv (copia e cola) e o qrCode.
Requisição
curl -X POST 'https://api.avanttifinance.com/v1/pix/in/qrcode' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer SEU_TOKEN' \
-d '{
"amountInCents": 8000,
"postbackUrl": "https://seu-sistema.com/webhooks/avantti",
"description": "Teste",
"customer": {
"name": "TESTE VENDA",
"email": "jvteste@teste.com",
"documentType": "cnpj",
"document": "07628652000114",
"phone": "(32) 99999-9999"
},
"items": [
{
"title": "Produto teste",
"tangible": true,
"quantity": 1,
"amountInCents": 2000
},
{
"title": "Produto teste 2",
"tangible": true,
"quantity": 2,
"amountInCents": 3000
}
],
"seller": {
"name": "Bruno Ribeiro do Vale",
"documentType": "cnpj",
"document": "07628652000114",
"phone": "(32) 88888-9999"
}
}'
Campos
Valor total da cobrança, em centavos.
Dados do pagador. documentType (cpf ou cnpj) e document são obrigatórios, e o documento é validado.
URL que receberá as notificações de mudança de status (webhook).
Descrição livre da cobrança.
Itens da compra. Quando enviado, a soma de amountInCents × quantity de todos os itens deve ser igual a amountInCents.
Dados do vendedor (marketplace/split). Opcional.
Se items for enviado e a soma não bater com amountInCents, a API retorna 400 com a mensagem
“O valor de amountInCents deve ser igual ao valor total dos itens”.
Resposta
{
"success": true,
"message": "Transação criada com sucesso",
"data": {
"id": "clxyz123abc",
"pix": {
"emv": "00020126580014br.gov.bcb.pix...",
"qrCode": "data:image/png;base64,iVBORw0KGgo..."
},
"status": "pending",
"fees": 200
}
}
Exiba o emv como “copia e cola” e/ou renderize o qrCode. Acompanhe o pagamento via Webhooks.