Sección 08

Respuestas y errores

Cómo interpreta AIC tus respuestas y qué errores devuelve su API.

Respuestas y errores#

Cómo interpreta AIC las respuestas de tu API#

AIC decide el resultado de cada llamada de wallet a partir del código HTTP y del cuerpo de tu respuesta:

Código	Mensaje	Descripción
200	data + status	Éxito. data es el nuevo balance del jugador y status lleva code "0"; si falta status, la respuesta se rechaza.
404	NOT_FOUND	Jugador no encontrado. Responde HTTP 404 con message NOT_FOUND.
400	OVERFLOW	Saldo insuficiente. Responde HTTP 400 con message OVERFLOW.
—	*	Cualquier otra respuesta (otro código HTTP, data no numérico o tiempo de espera agotado) hace que la operación falle hacia el proveedor.

Ejemplos de respuesta con error#

Jugador no encontrado (HTTP 404):

{
  "statusCode": 404,
  "message": "NOT_FOUND"
}

Saldo insuficiente (HTTP 400):

{
  "statusCode": 400,
  "message": "OVERFLOW"
}

Importante

Toda respuesta exitosa debe incluir data numérico y el objeto status (code: "0", message, datetime). Sin status, AIC rechaza la respuesta.

Nota

Según el proveedor, un jugador no encontrado o un saldo insuficiente se muestra en el juego con su motivo o como un error genérico. En ambos casos la operación no se aplica.

Errores de los endpoints de AIC#

Situación	Respuesta
Project ID o API Key inválidos en `login`	HTTP 403
Proyecto inexistente o inactivo en `getGameList`	HTTP 400 o 404
Juego que no se pudo abrir	Ver Abrir un juego
Merchant Name inexistente en `round-played`	HTTP 400 con `CUSTOMER_NOT_FOUND`
Transacción inexistente o de otro proyecto en `round-played`	HTTP 200 con `status.code` 404 o 409
Error inesperado	HTTP 400