Link de pagamento

Erros

Códigos de resposta do link de pagamento no API Gateway.

O corpo de erro traz message. Validação (422) também traz errors por campo.

HTTP	Quando	Mensagem
`401`	Token ausente ou inválido	A API recusa a chamada.
`403`	Token sem o scope da rota	Permissão insuficiente.
`404`	Aplicação sem conta vinculada	`Conta não encontrada.`
`404`	Id inexistente, ou de outra conta	`Checkout não encontrado.`
`409`	Mesmo `reference_id` com pedido diferente	`Checkout com este reference_id já existe com dados diferentes.`
`409`	Inativar `PAID`, `CANCELED` ou `FAILED`	`Checkout não pode ser inativado neste status.`
`422`	Campo obrigatório, formato ou regra de negócio	`Validation failed.` e o mapa `errors`

Casos comuns de 422:

Sem reference_id, due_date, customer.name, customer.tax_id ou payment_methods.
Sem amount e sem items.
amount diferente da soma das linhas, quando os dois são enviados.
CREDIT sem max_installments.
BOLETO sem endereço.
redirect_url ou notification_url que não começam com https://.
late_fee fora de 0 a 2, ou interest_rate fora de 0 a 1.
Item sem code.

Repetir o mesmo pedido, inclusive URLs e segredo, não é erro: a resposta é 200 com o mesmo id.

Um link de outra conta não aparece como 403. A resposta é 404, a mesma de um id inexistente. As mensagens da tabela são o texto exato da API.

Retorno e notificação

Como o pagador volta para a loja e como a Nuvende avisa que o link foi pago.

Homologação

Host do API Gateway, scopes e checklist para integrar o link de pagamento antes de produção.