Errores

​

Forma del error

{
  "errors": [
    {
      "message": "Offer out of stock",
      "extensions": {
        "code": "GC-0009",
        "path": ["purchaseGiftCard"],
        "requestId": "req_01H...Offer out of stock",
      "code": "GC-0009",
      "path": ["purchaseGiftCard"]
    }
  ]
}

• AUTH-* — problemas de autenticación y tokens
• BS-* — errores generales de negocio / validación
• GC-* — operaciones de tarjetas de regalo
• VC-* — operaciones de tarjetas virtuales

​

Códigos de error por dominio

​

Solución de problemas

1. Revisa el alcance en AUTH-*. Casi siempre significa que el token se generó sin el alcance requerido; genera un token nuevo.
2. AUTH-0002Vuelve a consultar antes de reintentar GC-*. Las ofertas y el stock cambian con frecuencia — obtén una oferta fresca y vuelve a intentar.
3. Vuelve a consultar antes de reintentar errores de negocio. GC-0009 (stock) y similares significan que el mundo cambió — no vuelvas a intentar con datos obsoletosNo vuelvas a intentar errores de validación. Los códigos VC-* y BS-* con intención tipo 4xx fallarán de forma idéntica al reintentar hasta que corrijas la entrada o el saldo.
4. Vuelve a intentar errores transitorios del servidor con backoff y jitterVuelve a intentar errores 5xx / de red con jitter. Las mutaciones de movimiento de dinero son desduplicadas; consulta Idempotencia.