Criar cobrança imediata

Cria uma cobrança Pix imediata (BR Code dinâmico) com txid gerado automaticamente.

POST/pix/cob

Parâmetros

ParâmetroTipoDescrição
calendario.expiracao*integerTempo de expiração em segundos.
valor.original*stringValor em formato "0.00".
chave*stringChave Pix do recebedor.
devedorobjectNome e documento do pagador.
solicitacaoPagadorstringMensagem ao pagador (até 140 chars).

Exemplo de requisição

curl -X POST https://api.pix.nixfin.com.br/pix/cob \
  -H "Authorization: Bearer $BS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
       "calendario": {
         "expiracao": 3600
       },
       "valor": {
         "original": "150.00"
       },
       "chave": "contato@bsfinance.tech",
       "solicitacaoPagador": "Pedido #4521"
     }'

Exemplo de resposta

{
  "txid": "BS9F2B3C7E8A4D1B6C5F0E9A8D2C1B4A",
  "revisao": 0,
  "status": "ATIVA",
  "calendario": { "criacao": "2026-04-23T14:00:00Z", "expiracao": 3600 },
  "valor": { "original": "150.00" },
  "loc": { "id": 9241, "location": "qrcodes.bsfinance.tech/v2/9241" },
  "pixCopiaECola": "00020126580014BR.GOV.BCB.PIX..."
}