Webhook y estados de la solicitud

¿Cómo funciona la notificación de estados? #

CrediSmart puede notificar al Ecommerce, de servidor a servidor, cada vez que cambia el estado de una solicitud.

La notificación se realiza mediante un Webhook enviado por HTTP con método POST y formato JSON a la callback_url registrada al crear la sesión.

Esto permite que el comercio o integrador actualice pedidos, CRM u otros sistemas sin depender únicamente de la redirección del navegador o de consultas manuales a las APIs.

Request #

Método: POST
Endpoint: misma callback_url registrada en /v1/session/init

Headers

Content-Type: application/json
Accept: application/json
User-Agent: CrediSmart-FinancingButton/1.0
X-Financing-Button-Delivery-Id: UUID del envío

Body

Campo	Tipo	Descripción
success	boolean	Indica que la petición fue procesada correctamente. Valor fijo: true.
code	number	Código de estado de la respuesta. Valor fijo: 200.
data	object	Objeto contenedor que incluye los detalles específicos de la sesión.

Datos de la notificación

Campo	Tipo	Descripción
status	string	Estado específico de la transacción en la pasarela.
partner_tx_id	string	Identificador único de la orden enviada al crear la solicitud.
signature	string	Hash de seguridad para validar la integridad del mensaje.
customer_document	string	Documento del cliente.
previous_status	string	Estado previo al cambio.

Ejemplo de notificación

curl --location '<callback_url>' \
--header 'Authorization: Bearer <AccessToken>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'User-Agent: CrediSmart-FinancingButton/1.0' \
--header 'X-Financing-Button-Delivery-Id: UUID del envío' \
--data '{
  "success": true,
  "code": 200,
  "data": {
    "status": "<estado actual del flujo>",
    "partner_tx_id": "<identificador de la solicitud normalizado>",
    "signature": "<HMAC-SHA256 en hexadecimal>",
    "customer_document": "<documento del cliente, si existe y no está vacío>",
    "previous_status": "<estado previo al cambio, si existía y no estaba vacío>"
  }
}'

Estados de la transacción

Estado	Descripción
Pendiente	Estado inicial de la transacción.
Abandonado	Estado generado por la inactividad del usuario durante un tiempo determinado (timeout).
Declinado	Estado generado cuando el usuario sale del flujo de la solicitud, por ejemplo cerrando la ventana de navegación.
Cancelado	Estado de transacciones que no pueden continuar por aplicación de reglas de negocio.
Rechazado	Estado generado cuando la transacción no aprueba las validaciones requeridas para la aprobación del crédito.
Aprobado	Estado generado cuando la solicitud de crédito es evaluada positivamente.
Otorgado	Estado generado cuando el crédito termina el flujo y está activo para el cliente.
Finalizado	Estado en el que queda el crédito otorgado cuando el cliente ha finalizado el pago del mismo.