Cash-out (pagamento)

Pix Cash-out por QR Code Estático

Realize pagamentos Pix instantâneos utilizando um QR Code estático. O QR Code estático contém apenas a chave Pix do beneficiário, permitindo que o valor seja definido no momento do pagamento.

Visão Geral

Através deste endpoint você pode:

  • Realizar pagamentos Pix por QR Code estático
  • Definir o valor no momento do pagamento
  • Pagar utilizando chave Pix do QR Code estático

Autenticação

Esta rota requer:

  • Token JWT no header Authorization (autenticação auth:api)
  • Assinatura HMAC no header X-Signature (middleware hmac-signature)

Endpoint

Nota: O pagamento por QR Code estático utiliza o mesmo endpoint de pagamento por chave Pix, onde a chave é extraída do QR Code estático. Consulte a documentação de Pagamento por Chaves Pix para mais detalhes.

Realizar Pagamento por QR Code Estático

POST /api/v2/baas/pix/payments/key

Para pagamentos por QR Code estático, você deve:

  1. Ler o QR Code estático para extrair a chave Pix
  2. Utilizar o endpoint de pagamento por chave com a chave extraída
  3. Definir o valor no momento do pagamento

Processo

  1. O QR Code estático contém apenas a chave Pix do beneficiário
  2. Ao ler o QR Code, extraia a chave Pix
  3. Utilize o endpoint de pagamento por chave com:
    • A chave extraída do QR Code
    • O valor desejado
    • Os demais campos obrigatórios

Exemplo de Requisição

{
  "value": 10000,
  "key": "chave-extraida-do-qr-code",
  "name": "Nome do Beneficiário",
  "ispb": "12345678",
  "agency": "0001",
  "account": "12345-6",
  "account_type": 1,
  "document": "12345678901",
  "person_type": 1,
  "type_initiation": 1,
  "idempotency_key": "550e8400-e29b-41d4-a716-446655440000",
  "description": "Pagamento via QR Code estático"
}

Diferenças entre QR Code Estático e Dinâmico

CaracterísticaQR Code EstáticoQR Code Dinâmico
ValorDefinido no pagamentoPode estar fixo no QR Code
InformaçõesApenas chave PixValor, beneficiário, descrição
Endpoint/pix/payments/key/pix/payments/payload
UsoPagamentos com valor variávelPagamentos com valor fixo ou variável

Próximos Passos

Para mais detalhes sobre pagamento por chave Pix, consulte:

  1. Pix Cash-out por Chaves Pix - Documentação completa
  2. Pix Cash-out por QR Code Dinâmico - Para QR Codes dinâmicos
  3. Consultar Extrato - Para verificar transações

2025 © Nuvende - CNPJ 38.297.374/0001-93