Códigos de error
Códigos de error comunes incluidos en esta documentación pública. La respuesta real del servidor prevalece.
Los errores de negocio devuelven JSON con code, message, data y requestId. Claves, firmas, timestamps, nonces inválidos o restricciones de seguridad pueden devolver HTTP 401 / 403 sin cuerpo ni código de negocio. Comprueba el estado HTTP y el cuerpo antes de analizar JSON. No tomes decisiones según el mensaje traducido.
Los códigos de autenticación describen el diagnóstico; no necesariamente se incluyen en los rechazos de seguridad públicos. HTTP 429 indica límite de solicitudes. Tras HTTP 5xx o timeout, consulta el pedido antes de reintentar para evitar pagos duplicados.
| Código | Descripción |
|---|---|
| 10001 | Parámetros de solicitud no válidos. |
| 20005 | API Key no válido. |
| 20011 | Firma de solicitud no válida. |
| 20012 | La firma timestamp está fuera de la ventana permitida. |
| 20016 | El nonce ya se ha utilizado. No reproduzca solicitudes. |
| 20020 | Too many requests. |
| 31001 | Cadena sin soporte. |
| 31002 | Token no compatible. |
| 31003 | La cadena y la ficha no coinciden. |
| 40002 | La encuadernación exclusiva en cartera no existe. |
| 40105 | El importe del pago compartido ya está reservado. |
| 40108 | La orden de pago no existe. |
| 51002 | This operation is blocked by the current merchant status or runtime policy. |
| 51004 | Insufficient fee balance. |
| 51008 | The current plan does not include this feature. |
| 53001 | Payout source address does not exist. |
| 53002 | Payout source address is unavailable. |
| 53003 | Saldo de token disponible insuficiente. |
| 54001 | La orden de pago no existe. |
| 54003 | The payout target cannot be one of the merchant's own wallet addresses. |
| 54004 | The merchant order number conflicts with an existing payout order. |