Pagamento por QR Code

Realize um pagamento Pix utilizando o payload de um QR Code.

O campo payment e um objeto com currency (sempre "BRL") e amount em reais com decimais. Ex: 100.00 = R$ 100,00.

Quando priority for "NORM" (padrao), o pagamento entra em fila e o campo expiration define o timeout em segundos (1-10800, padrao 600).

Quando priority for "HIGH", o campo creditorDocument (CPF/CNPJ do destinatario) e obrigatorio. Quando priority for "NORM" (padrao), o pagamento entra em fila e o campo expiration define o timeout em segundos.

POST/api/v2/pix/payments/qrc

Realiza um pagamento Pix utilizando o payload de um QR Code (string EMV). Suporta QR Codes estaticos e dinamicos.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2
`Content-Type`	application/json
`x-idempotency-key`	qrc-key-789e0123-e45b-67d8-a901-234567890abc	Chave unica para evitar pagamentos duplicados

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`priority`	string	Opcional	"HIGH" ou "NORM" (padrao). HIGH = processamento instantaneo, NORM = enfileirado
`paymentFlow`	string	Opcional	"APPROVAL_REQUIRED" ou "INSTANT" (padrao). Define se o pagamento requer aprovacao antes de ser processado
`expiration`	integer	Opcional	Timeout da fila em segundos (1-10800, padrao 600). Aplica-se apenas quando priority e "NORM"
`payment`	object	Obrigatorio	Objeto com currency ("BRL") e amount (valor em reais com decimais). Ex: { "currency": "BRL", "amount": 100.00 }
`payment.currency`	string	Obrigatorio	Moeda do pagamento. Sempre "BRL"
`payment.amount`	number	Obrigatorio	Valor em reais com decimais. Ex: 100.00 = R$ 100,00
`qrCode`	string	Obrigatorio	Payload do QR Code (string EMV / copia-e-cola do BCB)
`creditorDocument`	string	Opcional	CPF ou CNPJ do destinatario. Obrigatorio quando priority e "HIGH"

Exemplo de Request

{
  "priority": "NORM",
  "paymentFlow": "INSTANT",
  "expiration": 600,
  "payment": {
    "currency": "BRL",
    "amount": 100.00
  },
  "qrCode": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890520400005303986540510.005802BR5913Fulano de Tal6008Brasilia62070503***6304ABCD"
}

Exemplo de Response

{
  "id": "pay_qrc789xyz012",
  "status": "PROCESSING",
  "priority": "NORM",
  "paymentFlow": "INSTANT",
  "expiration": 600,
  "payment": {
    "currency": "BRL",
    "amount": 100.00
  },
  "idempotencyKey": "qrc-key-789e0123-e45b-67d8-a901-234567890abc",
  "createdAt": "2026-04-03T14: 00:00Z"
}

Exemplos de Codigo

curl -X POST \
  https://pagamentos.basspago.com.br/api/v2/pix/payments/qrc \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -H 'x-idempotency-key: qrc-key-789e0123-e45b-67d8-a901-234567890abc' \
  -d '{
    "priority": "NORM",
    "paymentFlow": "INSTANT",
    "expiration": 600,
    "payment": {
      "currency": "BRL",
      "amount": 100.00
    },
    "qrCode": "00020126580014br.gov.bcb.pix..."
  }'