Erros

Os erros devolvem um corpo JSON com um campo error e, muitas vezes, uma message com mais detalhe:

{
  "error": "You haven't set up a wallet address for the Polygon network",
  "message": "Please configure a Polygon-specific wallet in your merchant settings before accepting payments on this network.",
  "network": "polygon"
}

Códigos de estado

Código	Significado
400	o pedido foi rejeitado, leia error
401	credenciais em falta ou inválidas
404	o endpoint não existe, ou o recurso não existe nos endpoints que usam este código
500	algo falhou no servidor

Um ID de pagamento desconhecido devolve 500

Ler um pagamento que não existe devolve 500, não 404:

{ "success": false, "error": "Failed to query payment status" }

Isto afeta os endpoints de leitura de pagamentos e de depósitos. Outros endpoints devolvem 404 para um recurso que não existe, por isso o comportamento não é consistente em toda a API. Está documentado porque é o que acontece hoje: não assuma que um 500 nestas rotas significa necessariamente uma indisponibilidade do serviço. Verifique primeiro o ID.

Como uma mudança de 500 para 404 alteraria o código de estado de um resultado existente, conta como uma alteração incompatível segundo a nossa política de versionamento e não vai ser introduzida sem aviso na v1.

Repetir pedidos

As respostas 500 nos endpoints de leitura podem ser repetidas com segurança.

Repetir uma escrita só é seguro se o servidor conseguir reconhecer a repetição. Envie um cabeçalho Idempotency-Key, ou pelo menos o mesmo orderId. Consulte Repetir com segurança.