Cada error de la API llega con un código corto y un mensaje claro. Estos son los que más encuentran los comercios.
Credenciales y acceso
- unauthenticated / invalid_credentials: falta la clave del proyecto o el secreto, o son incorrectos. Busca espacios de más y comprueba que el secreto pertenece a este proyecto.
- project_inactive: usaste el secreto real antes de que se aprobara el proyecto. Hasta entonces, usa el secreto de prueba; consulta Revisión del proyecto: qué miramos.
- project_disabled: el proyecto está suspendido o no se aprobó.
- ip_not_allowed: la llamada vino de una dirección que no está en la lista de IP permitidas para la API del proyecto.
Tu petición
- invalid_request: falta un campo o tiene un formato incorrecto. El mensaje indica el campo.
- duplicate_order_id: ya existe un pago con este order ID en este modo. Usa uno nuevo o consulta el pago existente.
- insufficient_funds: el saldo no alcanza para una compra de skins. El mensaje indica cuánto hace falta.
Límites de llamadas
Un proyecto puede hacer hasta 600 llamadas por minuto. Por encima recibes rate_limited con una indicación de cuándo volver a intentarlo. Espera en lugar de reintentar en un bucle cerrado.
Cuando el mercado va lento
Si la red de pagos no responde, recibes un mensaje que te pide volver a intentarlo en un minuto. Los order ID y custom ID son únicos por proyecto, así que un reintento nunca puede crear un segundo pago ni una segunda compra. Repetir una llamada de compra con el mismo custom ID devuelve la compra existente.
La lista completa de errores, campos y ejemplos está en la referencia de la API.