Criando um QRCode PIX

Cria um QR Code PIX para recebimento de pagamentos.

Utilização do campo CALENDARIO e expiração

O campo expiration_date deve conter uma data futura. Caso seja informado um valor inferior à data e hora atuais, o sistema utilizará automaticamente o prazo de expiração padrão da instituição (1 dia).
É possível também utilizar o objeto CALENDARIO no formato BACEN para enviar a expiração.
Nesse objeto é necessário enviar em SEGUNDOS o tempo de expiração do QRCODE.

Atenção
O campo CALENDARIO sobreescreve o campo expiration_date, caso os dois sejam enviado o CALENDÁRIO será aplicado.

Criando QRCodes para um pagador específico

A api possibilita a criação de QRCodes dinâmicos com a segurança de apenas o DEVEDOR/PAGADOR(objeto payer) poderem efetuar o pagamento.

O request para esse regra deve contem as regras abaixo.

Informar os dados do campo PAYER

Informar a flag "pagamento_somente_devedor" como TRUE

    {
    "amount": 22,
    "external_id": "testebrasilcashnalon1111130",
    "type": "dynamic",
    "expiration_date": "2026-10-05 13:52:00",
    "calendario": {
        "expiracao":123000
    },
    "key": "your-key",
    "pagamento_apenas_devedor": true,
    "payer": {
        "name":"Teste BrasilCash",
        "document":"30507541000171",
        "email":"teste@brasilcash.com.br"
    }
}

Atenção
Essa regra faz que um cliente que não é o pagador configurado tentar efetuar o pagamento, o banco negará o QRCODE no momento da autorização da transação, não performando o recebimento.

curl --location '/v2/pix/qrcode?withImage=false' \ --header 'X-Account-Id: c5d6b7b2-b758-43a6-a474-63ebe97ca120' \ --header 'Content-Type: application/json' \ --data '{ "amount": 89, "external_id": "teste_brasilcash_nalon", "expiration_date": "2025-05-10 01:13:39", "type": "dynamic", "key": "1e902304-0f3d-46fa-805f-f1371e950e32" }'

{ "pix_id": "70", "type": "dynamic", "paid": true, "base64": "qrcode", "qrcode": "13", "amount": 51, "expiration_date": "2026-10-15T00:26:44.908Z", "created_at": "2026-10-14T02:32:13.817Z", "payer": { "document": "amet", "document_type": "elit", "name": "Mariana Xavier" } }

Utilização do campo CALENDARIO e expiração

Criando QRCodes para um pagador específico

Requisição

Respostas

Criando um QRCode PIX

Utilização do campo CALENDARIO e expiração#

Criando QRCodes para um pagador específico#

Requisição

Respostas

Utilização do campo CALENDARIO e expiração

Criando QRCodes para um pagador específico