Codici di errore

L'oggetto di erroreChiedi ad Athia informazioni#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "message": "The payment was declined by the payment provider.",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP",
    "doc_url": "/errors#payment-declined"
  }
}

• code — identificatore stabile a ramificazione.
• message — leggibile dall'uomo, può cambiare. Non lo faccia parsa.
• request_id — includere nel contatto con il supporto.

Riferimento erroreChiedi ad Athia informazioni#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP"
  }
}

{
  "error": {
    "code": "CARD_EXPIRED",
    "request_id": "req_2Pb8XwQ"
  }
}

{
  "error": {
    "code": "INVALID_REQUEST",
    "param": "amount",
    "message": "amount must be an integer."
  }
}

{
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "request_id": "req_9Qd1MnZ"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "param": "id"
  }
}

{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "request_id": "req_4Tr6VbS"
  }
}

{
  "error": "rate_limit_exceeded",
  "message": "maximum requests",
  "code": 429,
  "endpoint": "/merchants/orders",
  "total_requests": 101,
  "retry_after": "1s"
}

{
  "error": {
    "code": "PROVIDER_UNAVAILABLE",
    "routing": { "attempts": 2 }
  }
}

Catalogo degli errori di pagamento e ordineChiedi ad Athia informazioni#

Questo catalogo ripristina l'insieme completo di codici stabili dal riferimento precedente dei codici di risposta pubblici. I codici attuali sono stati controllati rispetto ai percorsi di codice delle API di pagamento e ordine; i codici "legacy" rimangono elencati per la compatibilità con le versioni precedenti. I messaggi possono variare; è necessario fare riferimento al codice piuttosto che analizzare il testo del messaggio.

Ordini e checkout

Ciclo di vita dell'ordine, prontezza del checkout, link di pagamento, gestione dei file e delle richieste.

Pagamenti

Validazione, elaborazione, autenticazione e operazioni di transazione dei pagamenti e risposte del provider.

Risposte dell'ordine del commerciante

Errori restituiti durante la validazione delle risposte dell'ordine, della spedizione e dei coupon del commerciante.

Antifrode

Errori di valutazione antifrode stabili restituiti nelle operazioni di pagamento e ordine.

Gestione degli erroriChiedi ad Athia informazioni#

1. Branch su error.code; tronchi request_id.
2. Retribuzioni 5xx e 429 con lo schienale e lo stesso Idempotency-Key.
3. Mai più 400, 401 o 402 unchanged.