PIX cash-in

Estas rotas não estão montadas na superfície atual e respondem 404. Elas dependem da liberação comercial de pagamentos e do escopo payments:create, que é recusado na criação da credencial. A página descreve o contrato para você planejar a integração; confirme a liberação com a PrismaPay antes de codar contra ela.

O que já funciona hoje no fluxo de entrada é o aviso de crédito: quando um PIX cai numa conta que você gerencia, você recebe o webhook pix.cashin.received. Ver Webhooks.

Rotas

Método	Rota	Recebe em
`POST`	`/v1/pix/qrcode`	conta raiz
`POST`	`/v1/accounts/{accountId}/pix/qrcode`	conta gerenciada

Escopo payments:create. Idempotency-Key obrigatório nas duas.

Corpo

Campo	Tipo	Regra
`amountCents`	inteiro	obrigatório, positivo, em centavos
`description`	string	opcional, até 140 caracteres, sem caracteres de controle
`expiresInSeconds`	inteiro	opcional, de 900 a 86400, padrão 3600

{
  "amountCents": 5000,
  "description": "Pedido 1234",
  "expiresInSeconds": 3600
}

description chega ao pagador na mensagem do PIX. Não coloque dado pessoal nem informação interna ali.

Exemplo

curl -X POST https://api.prismapay.com.br/v1/accounts/{accountId}/pix/qrcode \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7b2e8f6e-4f4d-4f93-b8d3-9c2f2c32e2b1" \
  -H "X-Api-Key: pk_live_seu_key_id" \
  -H "X-Timestamp: 1767000000" \
  -H "X-Signature: assinatura_hex" \
  -d '{"amountCents":5000,"description":"Pedido 1234"}'

A resposta traz o BR Code para você exibir ao pagador.

A Idempotency-Key é obrigatória por um motivo prático: sem ela, uma retentativa geraria um segundo QR Code e um segundo crédito pendente para a mesma cobrança. Com ela, a retentativa devolve o QR original.

Confirmação do crédito

O crédito é assíncrono. Você tem dois caminhos, e o certo é usar os dois:

Webhook, em tempo real

pix.cashin.received chega com amountCents e endToEndId assim que o crédito é confirmado na origem.

Log de entregas, para reconciliar

GET /v1/webhooks/deliveries mostra tudo que tentamos enviar, inclusive o que o seu endpoint não recebeu. Ver Webhooks.

Não trate a criação do QR Code como recebimento. O dinheiro só existe depois do evento de crédito. Liberar mercadoria na resposta do QR Code é o erro clássico desse fluxo.

Comece aqui

Fundamentos

Contas

Movimentação

Rotas

Corpo

Exemplo

Confirmação do crédito

​Rotas

​Corpo

​Exemplo

​Confirmação do crédito

Rotas

Corpo

Exemplo

Confirmação do crédito