Códigos de error

El objeto de errorPreguntar a Athia sobre esto#

{
  "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 — Identificador estable para poder ramificar.
• message — Legible por el usuario, puede cambiar. No lo parsees.
• request_id — Inclúyelo al contactar con el soporte.

Referencia de errorPreguntar a Athia sobre esto#

{
  "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 }
  }
}

Catálogo de errores de pagos y pedidosPreguntar a Athia sobre esto#

Este catálogo restaura el conjunto completo de códigos estables del anterior documento de referencia de códigos. Los códigos actuales se han verificado con las rutas de código de las APIs de pagos y pedidos; los códigos solo para sistemas heredados siguen listados para la compatibilidad hacia atrás. Los mensajes pueden variar; utilice el código en lugar de analizar el texto del mensaje.

Pedidos y proceso de pago

Ciclo de vida del pedido, preparación para el pago, enlaces de pago, archivos y manejo de solicitudes.

Pagos

Validación de pago, procesamiento, autenticación, operaciones de transacción y respuestas del proveedor.

Respuestas del comerciante

Errores devueltos al validar las respuestas del comerciante, la entrega y los cupones.

Antifraude

Errores de evaluación de fraude estables devueltos con las operaciones de pago y pedido.

Manejo de erroresPreguntar a Athia sobre esto#

1. Ramificar en error.code; registrar request_id.
2. Intentar de nuevo 5xx y 429 con retroceso y el mismo Idempotency-Key.
3. Nunca intente de nuevo 400, 401 o 402 unchanged.