Base URL:
Todos os valores monetários são inteiros em centavos. R$ 50,00 é 5000.

Estado das rotas

Ativa

Montada em produção. Basta ter o escopo na sua credencial.

Aguardando liberação

Implementada, porém não montada: hoje responde 404. Depende de liberação comercial e do escopo payments:create, que hoje é recusado na própria criação da credencial.

Contas e onboarding

Detalhes em Contas gerenciadas, Onboarding PF e Onboarding PJ.

Webhooks

O envio dos eventos parte de nós; esta rota é o log para você reconciliar. Ver Webhooks.

PIX

Contratos em PIX cash-in e PIX cash-out.

O que não existe nesta API

Para evitar planejamento em cima de suposição:
  • Boleto: emissão, consulta e pagamento não têm rota de parceiro exposta.
  • Cripto: carteira, portfólio e taxa de rede não têm rota de parceiro exposta.
  • Contas globais, câmbio, pagamentos internacionais e mesa OTC não fazem parte desta superfície. Ver Produtos PrismaPay.
Uma rota inexistente responde 404, igual a uma rota aguardando liberação. Não tente inferir capacidade a partir do código de resposta.

Contrato comum a todas as rotas

Assinatura HMAC-SHA256

Três headers em toda chamada, janela de 5 minutos, assinatura de uso único.

Idempotência

Header obrigatório em toda operação que altera estado, janela de 24 h.

Erros padronizados

Sempre code + status. Só três famílias de erro são retentáveis.

Centavos inteiros

Nunca use ponto flutuante para dinheiro. R$ 50,00 é 5000.

Limites operacionais