Criar QR Code

Cria uma cobranca Pix com QR Code dinamico (Pix Cob). O txid e gerado automaticamente pelo sistema.

POST/cob

Cria uma cobranca Pix com QR Code dinamico. O txid sera gerado automaticamente e retornado na resposta.

Base URL: https://api.pix.basspago.com.br

Headers

Header	Valor	Descricao
`Content-Type`	application/json	Tipo do conteudo da requisicao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`calendario.expiracao`	integer	Obrigatorio	Tempo de expiracao da cobranca em segundos
`devedor.cpf`	string	Opcional	CPF do devedor
`devedor.nome`	string	Opcional	Nome do devedor
`valor.original`	string	Obrigatorio	Valor da cobranca em BRL (ex: "10.00")
`chave`	string	Obrigatorio	Chave Pix cadastrada na conta
`solicitacaoPagador`	string	Opcional	Descricao do pagamento visivel para o pagador
`infoAdicionais`	array	Opcional	Informacoes adicionais em formato [{nome, valor}]

Exemplo de Request

{
  "calendario": {
    "expiracao": 3600
  },
  "devedor": {
    "cpf": "12345678909",
    "nome": "Fulano de Tal"
  },
  "valor": {
    "original": "10.00"
  },
  "chave": "sua-chave-pix@example.com",
  "solicitacaoPagador": "Pagamento do pedido #12345",
  "infoAdicionais": [
    {
      "nome": "Pedido",
      "valor": "12345"
    }
  ]
}

Exemplo de Response

{
  "calendario": {
    "criacao": "2025-01-15T10:30:00.000Z",
    "expiracao": 3600
  },
  "txid": "fc9a43e0b7e14b5a8c3d2f1e0a9b8c7d",
  "revisao": 0,
  "loc": {
    "id": 1234,
    "location": "pix.example.com/qr/v2/abc123def456",
    "tipoCob": "cob"
  },
  "location": "pix.example.com/qr/v2/abc123def456",
  "status": "ATIVA",
  "devedor": {
    "cpf": "12345678909",
    "nome": "Fulano de Tal"
  },
  "valor": {
    "original": "10.00"
  },
  "chave": "sua-chave-pix@example.com",
  "solicitacaoPagador": "Pagamento do pedido #12345",
  "infoAdicionais": [
    {
      "nome": "Pedido",
      "valor": "12345"
    }
  ],
  "pixCopiaECola": "00020126580014br.gov.bcb.pix..."
}

Exemplos de Codigo

curl -X POST https://api.pix.basspago.com.br/cob \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "calendario": {
      "expiracao": 3600
    },
    "devedor": {
      "cpf": "12345678909",
      "nome": "Fulano de Tal"
    },
    "valor": {
      "original": "10.00"
    },
    "chave": "sua-chave-pix@example.com",
    "solicitacaoPagador": "Pagamento do pedido #12345"
  }'