Códigos de respuesta

Todos los endpoints devuelven un objeto status con un code y una description. El código YP-0000 siempre indica éxito.

Estructura de la respuesta

{
  "status": {
    "code": "YP-0000",
    "description": "Se ha realizado la ejecución del servicio correctamente"
  },
  "body": { ... }
}
HTTP 200 no significa éxito

La API puede devolver HTTP 200 con un código de error en status.code. Verifica siempre el campo status.code en tu integración — no solo el código HTTP.

Sesión (/session/login, /session/logout)

CódigoNombreDescripciónAcción recomendada
YP-0000SUCCESSOperación exitosa.—
YP-0006FAIL_OPENError al procesar el login o sesión expirada.Regenera el code HMAC y reintenta el login.

Historial de movimientos (/movement/history, /movement/{id})

CódigoNombreDescripciónAcción recomendada
YP-0000SUCCESSOperación exitosa.—
YP-0001NO_DATAConsulta exitosa pero sin resultados para los criterios indicados.Revisa el rango de fechas o el filtro aplicado.
YP-0039INVALID_ALIAS_NUMEl número de alias en el filtro supera el máximo de 25.Divide la consulta en múltiples requests con menos de 25 alias.
YP-0040INVALID_LIMITEl valor de limit está fuera del rango permitido.Ajusta el limit al rango válido.
YP-0010INVALID_PARAMETERSUno o más campos del body tienen valores no válidos.Revisa el formato de fechas y demás campos.

Métodos de cobro (/collection-method)

CódigoNombreDescripciónAcción recomendada
YP-0000SUCCESSOperación exitosa.—

Anulación de transacciones (/transaction/{id})

CódigoNombreDescripciónAcción recomendada
YP-0000SUCCESSAnulación procesada correctamente.—
YP-0013FAIL_REFUNDError interno al procesar la reversa.Reintenta. Si persiste, escala a soporte de Yappy.
YP-0014TRANSACTION_SETTLEDLa transacción ya fue liquidada — no se puede anular.No se requiere acción; la transacción está cerrada.
YP-0015REFUND_FAILEDLa transacción está en estado fallido.No se requiere acción; si ocurre con frecuencia, escala a soporte.
YP-0016ALREADY_REFUNDLa transacción ya estaba anulada.No se requiere acción adicional.

Errores generales (todos los endpoints)

CódigoNombreDescripciónAcción recomendada
YP-0002FAIL_ERRORError genérico al procesar los datos.Reintenta con backoff exponencial. Si persiste, contacta soporte.
YP-0008MISSING_PARAMETERSFaltan headers obligatorios en el request.Verifica que api-key, secret-key y authorization (donde aplique) estén presentes.
YP-9999TIMEOUT_ERRORLa operación tardó demasiado.Reintenta con backoff. Puede indicar alta carga en la plataforma.
¿Te fue útil esta página?