Botón de Pagos

Documentación técnica para integrar Botón de Pagos CrediSmart en plataformas de Ecommerce. Te invitamos a encontrar la información que necesitas a continuación o en el campo de búsqueda:

Inicio › Botón de Pagos › Consulta de una orden

Consulta de una orden

¿Para qué sirve esta consulta?

La comunicación principal del estado de una transacción hacia el Ecommerce se realiza mediante el Webhook. Adicionalmente, CrediSmart permite consultar el estado de una orden mediante una API de Consulta (Callback).

Esta consulta es opcional y permite al Ecommerce obtener el estado de una orden creada.

Request

Método: GET
Endpoint: /v1/callback

Headers

Content-Type: application/json
Accept: application/json
Authorization: Bearer <accessToken>

Parámetros

CampoTipoObligatorioDescripción
customer_documentnumberSíDocumento de identidad del cliente.
external_order_idnumberSíNúmero de orden enviada al crear la solicitud.

Respuesta

CampoTipoDescripción
successbooleanIndica que la petición fue procesada correctamente. Valor fijo: true.
codenumberCódigo de estado de la respuesta. Valor fijo: 200.
dataobjectObjeto contenedor que incluye los detalles específicos de la sesión.

Datos de la respuesta

CampoTipoDescripción
statusstringEstado específico de la transacción en la pasarela.
partner_tx_idstringIdentificador único de la orden enviada al crear la solicitud.
signaturestringHash de seguridad para validar la integridad del mensaje.

Respuesta ejemplo

{
  "success": true,
  "code": 200,
  "data": {
    "status": "PENDIENTE",
    "partner_tx_id": "TEST-000004",
    "signature": "9de04bc9d22cd8347503b84b5af8bdeb41985625b5cd93d891e217291a271917"
  }
}

Ejemplo de petición

curl --location '<URL POR DEFINIR>/v1/callback?customer_document=123456789&external_order_id=000001' \
--header 'Authorization: Bearer <AccessToken>' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json'