Gerar QR Code dinâmico para venda única

POST

/api/Pix/SolicitarEcommerceQrCode

Pix

Funcionalidade principal

O endpoint SolicitarEcommerceQrCode é utilizado para gerar um QR Code Dinâmico exclusivo para uma transação de venda. Diferente de um QR Code estático, este permite que o recebedor (loja) atrele um valor exato, um prazo de expiração (TTL) e identifique exatamente qual pedido está sendo pago assim que a liquidação ocorre no Banco Central.

Casos de uso comuns

Checkout de e-commerce: No momento de finalizar a compra, o site exibe o QR Code e o "Pix Copia e Cola" para o cliente pagar imediatamente.

PDV físico (Ponto de venda): O sistema de caixa gera um QR Code no monitor para o cliente escanear e pagar sem necessidade de maquininha de cartão.

Vendas via chat/redes sociais: Envio do link ou código do Pix para pagamentos em conversas de WhatsApp ou redes sociais.

Requisição

Authorization

Adicionar o parâmetro

Authorization

a Cabeçalhos, cujo valor é concatenar o Token após o Bearer.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Correto

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/Pix/SolicitarEcommerceQrCode' \
--header 'UserName;' \
--header 'RequestOrigin;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Data": {
        "CodigoCanal": 0,
        "CodigoCliente": 0,
        "KeyLoja": "string",
        "DataVencimento": "2019-08-24T14:15:22.123Z",
        "SegundosExpiracao": 0,
        "Valor": 0,
        "WebHookPagamento": false
    }
}'

Response Example

{
    "Data": {
        "PinbankQrCodeId": 0,
        "NsuPinbank": "string",
        "TextoQrCode": "string"
    },
    "ResultCode": 0,
    "Message": "string",
    "ValidationData": {
        "ResultCode": 0,
        "Message": "string",
        "Errors": [
            {
                "ErrorMessage": "string",
                "FieldName": "string"
            }
        ]
    }
}

Modificado em 2026-03-03 15:09:40

Página anterior

Gerenciar trava de compras online (E-commerce)

Próxima página

Solicitar estorno parcial ou integral de um Pix

Gerar QR Code dinâmico para venda única

Funcionalidade principal#

Casos de uso comuns#

Requisição

Respostas

Funcionalidade principal

Casos de uso comuns