ROKIConnect

Catálogo de errores

HTTP Cuándo Forma
401 Falta Authorization o la llave es inválida {"message": "..."}
404 (aplicación) El pago no existe para esa llave {"message":"Pago no encontrado."}
404 (ruteo) La ruta no existe {"message":"The route ... could not be found."} - siempre en inglés
405 Método equivocado {"message":"The GET method is not supported for route ... Supported methods: POST."}
422 Validación o regla de negocio {"message":"...", "errors":{"field":["..."]}}

El message de un 422 contiene el primer error, con el sufijo (and N more errors) cuando hay varios; errors los agrupa por campo. No hay códigos de error legibles por máquina: no armes lógica a partir de coincidencias de texto, porque el texto cambia con Accept-Language y puede ser reescrito. Ramifica según el estado HTTP y según las llaves del objeto errors, que sí son estables.

15.1 Mensajes 422 comunes

Mensaje Causa
El campo amount es obligatorio. Falta un campo obligatorio
El campo amount debe ser al menos 0.01. Monto por debajo del mínimo
La moneda seleccionada no esta disponible en su terminal de enlaces de pago. currency_code no habilitado
La fecha de vencimiento debe ser en el futuro. expires_at en el pasado
El campo metadata debe ser un array. metadata enviado como cadena de texto
Ingrese un monto o porcentaje de impuesto cuando el impuesto esta habilitado. Falta sales_tax_value
El porcentaje no puede superar 100%. sales_tax_value mayor a 100 en modo porcentaje
Seleccione un tipo de propina o permita la seleccion del cliente en el checkout. tip_enabled sin un modo
Los limites de propina no pueden ser mayores que el monto del plan. tip_max_amount mayor que amount
El entorno sandbox no esta configurado para enlaces de pago... Sandbox no aprovisionado para ese comercio (16.2)