Cria uma cobrança (PIX ou cartão)
POST/integration/v1/charges
No PIX, a resposta já traz pixPayload (copia e cola) e qrCodeImage.
No cartão, traz checkoutUrl — a página hospedada, com a marca que o
pagador reconhece, que trata os dados do cartão e o 3-D Secure.
Não existe caminho para dados de cartão nesta API. Não há campo capaz de recebê-los, e isso é o desenho, não uma lacuna: o PAN não passa pelo seu servidor, e é isso que mantém o seu escopo de PCI onde ele está.
O modo (test/live) vem da credencial e é gravado na cobrança.
Nunca é parâmetro da chamada — seria um erro de digitação de distância
entre um teste e dinheiro real.
Requisição
Respostas
- 201
- 401
- 403
- 422
- 503
Cobrança criada.
error.code = invalid_signature. Cobre chave desconhecida, assinatura
incorreta, cabeçalho ausente, instante fora da tolerância de 300s e
nonce repetido — deliberadamente indistinguíveis, para não
transformar o endpoint num verificador de quais chaves existem.
Conta indisponível para operar, ou valor acima do limite do nível de
verificação. error.code = forbidden ou kyc_limit_exceeded.
error.details traz um mapa campo → lista de mensagens.
error.code = service_temporarily_unavailable. A operação não pode
ser processada agora — nenhum caminho disponível, ou nenhum habilitado
para o modo da sua credencial.
Uma chave de teste numa conta sem ambiente de teste configurado recebe isto, e é a resposta honesta: a alternativa seria roteá-la para produção e você descobrir movimentando dinheiro de verdade.
Recuo exponencial ao repetir; a cobrança não foi criada.