Pagamento por QR Code

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

O valor (amount) deve ser informado em centavos. Por exemplo, 1000 = R$ 10,00.

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

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`qrCode`	string	Obrigatorio	Payload do QR Code (string EMV)
`amount`	integer	Obrigatorio	Valor em centavos. Ex: 1000 = R$ 10,00
`description`	string	Opcional	Descricao do pagamento
`idempotencyKey`	string	Obrigatorio	Chave unica para evitar pagamentos duplicados

Exemplo de Request

{
  "qrCode": "00020126580014br.gov.bcb.pix0136a1b2c3d4-e5f6-7890-abcd-ef1234567890520400005303986540510.005802BR5913Fulano de Tal6008Brasilia62070503***6304ABCD",
  "amount": 1000,
  "description": "QR Code payment",
  "idempotencyKey": "qrc-key-789e0123-e45b-67d8-a901-234567890abc"
}

Exemplo de Response

{
  "id": "pay_qrc789xyz012",
  "status": "PROCESSING",
  "amount": 1000,
  "description": "QR Code payment",
  "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' \
  -d '{
    "qrCode": "00020126580014br.gov.bcb.pix...",
    "amount": 1000,
    "description": "QR Code payment",
    "idempotencyKey": "qrc-key-789e0123-e45b-67d8-a901-234567890abc"
  }'