Legacy: PIX QR Code

Endpoint legado — será desabilitado em breve. Migre para POST /v2/transactions/cashin o quanto antes. Após a data de descontinuação, esta rota retornará 410 Gone e novas integrações devem usar exclusivamente o endpoint moderno.

Requer autenticação

POST/v2/pix/qrcode

Gera um QR Code PIX para recebimento. Retorna o código copia-e-cola e os dados do devedor.

Parâmetros

amountnumberobrigatório

Valor da cobrança em BRL.

external_idstring

ID único no seu sistema para idempotência.

payer.namestring

Nome do pagador.

payer.documentstring

CPF ou CNPJ do pagador.

descriptionstring

Descrição da cobrança.

Rate limit

12 000 reqs/min por credencial (mesmo limite do /v2/transactions/cashin moderno).

Erros

Código	HTTP	Descrição
`MISSING_REQUIRED_FIELD`	400	`amount` ausente
`INVALID_AMOUNT`	422	Valor inválido ou abaixo do mínimo
`BELOW_MIN_LIMIT`	409	Abaixo do mínimo PIX
`EXCEEDS_MAX_LIMIT`	409	Acima do máximo permitido
`LIMIT_EXCEEDED`	409	Limite diário atingido
`DUPLICATE_EXTERNAL_ID`	409	`external_id` já utilizado
`PROVIDER_ERROR`	502	Erro no provedor — retryable

cURL

PHP

JavaScript

Python

curl -X POST https://api.bspay.co/v2/pix/qrcode \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10.00,
    "external_id": "order_001",
    "payer": {
      "name": "João da Silva",
      "document": "12345678901"
    },
    "description": "Pedido #001"
  }'

Resposta 200

{
  "transactionId": "03553b00d4b3e0f32fd398e558a2c99c",
  "external_id": "order_001",
  "status": "PENDING",
  "amount": 10,
  "calendar": {
    "expiration": 3600,
    "dueDate": "2026-04-04 10:19:17"
  },
  "debtor": {
    "name": "João da Silva",
    "document": "12345678901"
  },
  "qrcode": "00020101021226640014br.gov.bcb.pix2542pix.magenpay.io/cob/4HQzgpKZR0uiYG_rdQpWrg5204000053039865802BR5925PIXUP SERVICOS E INTERMED6008SALVADOR62070503***630473BE"
}

AnteriorTaxasPróximoLegacy: PIX Payment (Cashout)