Resumen de órdenes y errores de Scalapay

Errores

La API de Scalapay utiliza códigos de estado HTTP estándar para indicar el resultado de las solicitudes. En caso de error, se devuelve una respuesta en formato JSON con información detallada.

Códigos de estado HTTP

Código	Descripción
2XX	La solicitud se ha realizado correctamente.
4XX	La solicitud no es válida (por ejemplo, faltan parámetros obligatorios o los datos son incorrectos).
5XX	Error inesperado del lado del servidor de Scalapay.

Estructura de la respuesta de error

Las respuestas de error contienen información útil para diagnosticar problemas. Aunque el mensaje en formato legible puede cambiar con el tiempo, se recomienda basarse en el código de error y el código de estado HTTP para la gestión de errores.

Atributo	Tipo	Descripción
`errorCode`	string	Código de identificación del error (e.g.`order_amount_exceeds_maximum_limit`).
`errorId`	string	Identificador único del error.
`message`	string	Descripción legible del error. Podría actualizarse, no lo utilices para la lógica de la aplicación.
`httpStatusCode`	integer	Código de estado HTTP asociado al error.

Orden de prueba

Cómo realizar un pedido de prueba con Scalapay

Elija un producto con un importe inferior al máximo permitido.
Rellene los datos del carrito con información ficticia.
Seleccione Scalapay como método de pago.
Inicie sesión en Scalapay con un usuario de prueba (el mismo que utiliza en el portal de clientes, o cree uno nuevo).
Introduzca la información de su tarjeta de prueba (ver más abajo) para completar su pedido.
Compruebe que se le ha redirigido correctamente a la página de confirmación de su sitio web.

Cartas de Prueba

Tarjetas para pruebas con resultados positivos

5200 8282 8282 8210
5555 5555 5555 4444
4242 4242 4242 4242

Tarjetas para pruebas con resultados negativos

4000 0000 0000 0341
4000 0000 0000 0002
4000 0000 0000 9995

Para todos:

CVV: cualquier código (por ejemplo, 123)
Fecha de caducidad: cualquier fecha futura
Código postal: cualquier código postal válido

Todas las tarjetas mostradas funcionan, puedes probarla a alternarlas.

Estado de la orden

Cada orden tiene dos tipos de estados: Order Status y Capture Status.

Order Status

Estados	Descripción
`pending`	El pedido ha sido creado, pero aún no ha sido autorizado por el cliente. Permanece en este estado durante 40 minutos si no se completa.
`expired`	El pedido ha caducado sin autorización del cliente.
`refunded_not_charged`	La orden expiró, pero había sido autorizada. La captura no se efectuó.
`charged`	La orden fue capturada correctamente.
`partially_refunded`	El pedido se reembolsó parcialmente.
`refunded`	Se ha devuelto el importe íntegro del pedido.

Estado de la captura

Estados	Descripción
`pending`	La orden aún no ha sido capturada.
`captured`	La orden fue capturada correctamente.
`delayed`	La captura se ha retrasado (por defecto: 5 días).
`voided`	La orden fue cancelada antes de la captura.

Puede descargar el archivo con la combinación de estados desde este enlace:[Order Status and Capture Status.pdf].

Visualización de pedidos en el portal del vendedor

En la sección Pedidos del portal del vendedor, los pedidos se muestran con los siguientes estados:

Paid (Charged) - Pedido finalizado con éxito
Authorised - Sólo visible temporalmente; si se completa cambia a "Pagado", de lo contrario caduca y ya no aparece
Refunded / Partially refunded - Pedidos reembolsados, con detalles del importe.

Nota: Los pedidos en estado refunded_not_charged y expired no se muestran en el backend.

Los pedidos expired no indican errores técnicos, sino simplemente pedidos abandonados o rechazados por el banco del cliente. Por razones de privacidad, Scalapay no puede facilitar los motivos del rechazo.

Los pedidos Refunded_not_Charged, en cambio, se deben a problemas técnicos.

Comprobaciones en caso de Refunded_not_Charged

Integración personalizada:
- Verifica que el flujo implementado es correcto.
- Consulte la documentación oficial en este enlace: [Enlace a la documentación].
- Compruebe que la llamada Order Capture está presente y se ejecuta en el momento adecuado: cuando la orden está en estado autorizado (verificable con GET ORDER o mediante Webhook).
- Si utiliza la llamada Delay, compruebe que el campo authorizationExpiryMilliseconds se rellena de esta forma

{ "authorizationExpiryMilliseconds": 
432000000 }

Integración vía Plugin:
- Comprobar que la versión del plugin está actualizada: [Link Changelog].
- Compruebe que en el plugin el campo Estado del pedido: Payment Complete esté correctamente configurado según la documentación. Si se modifica, es posible que el flujo no se complete.
- Elija su plataforma en este enlace: [Documentación] para comprobar los pantallazos y los valores correctos.

Integración a través de Shopify:
- Consulta este enlace de documentación: [Documentación de Shopify] para comprobar los ajustes o configurar correctamente la captura diferida.