Skip to main content
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

amountInCents
integer
required
Valor total da cobrança, em centavos.
customer
object
required
Dados do pagador. documentType (cpf ou cnpj) e document são obrigatórios, e o documento é validado.
postbackUrl
string
URL que receberá as notificações de mudança de status (webhook).
description
string
Descrição livre da cobrança.
items
array
Itens da compra. Quando enviado, a soma de amountInCents × quantity de todos os itens deve ser igual a amountInCents.
seller
object
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.