Pago con Token

La funcionalidad de pago con token proporciona a los comerciantes y usuarios una capa adicional de seguridad y conveniencia al realizar transacciones recurrentes o almacenar información de tarjetas de manera segura. Al utilizar esta característica, los comerciantes pueden simplificar el proceso de pago y mejorar la experiencia del usuario.

Generación de token: Cuando un usuario realiza una transacción exitosa por primera vez y selecciona la opción de guardado de tarjeta, la pasarela de pagos genera un token único asociado a la tarjeta de crédito o débito del usuario. Este token sustituye los detalles sensibles de la tarjeta y se utiliza para identificar de manera única la cuenta del usuario en transacciones futuras.

Este endpoint recibe los datos de la transacción de pago/preautorización. y devuelve el resultado.
Method: post
URL: http://{environment-domain}/api/v1/make-token-payment
Encabezados HTTP: Content-Type: application/json
Agregar encabezados de autenticación

Ejemplo:

{
    "transactionType": "sale",
    "merchantId": "3ae25846-d5fe-40cc-a311-eb2de5174c29",
    "terminalId": "3ae25846-d5fe-40cc-a311-eb2de5174c29",
    "order": {
        "merchantOrderId": "9a6ecf36-8265-11ee-b962-0242ac120002",
        "amount": "100.00",
        "currency": "484"
    },
    "card": {
        "token": "a371f431-b300-44f8-820c-abccf6d45f98"
    },
    "installments": {
        "initialDiferement": 0,
        "numberInstallments": 0,
        "planType": "0"
    }
}

Descripción de campos

Campo	Descripción	Nota
`id`	Id único de la transacción asignado por la pasarela de pagos.
`merchantId`	Identificador único del comerciante en la pasarela de pago, es asignado al momento de crear
`terminalId`	Identificador único de la terminal, es asignado al momento de crear la cuenta.
`order`	Contiene detalles sobre la orden de compra.
`merchantOrderId`	Identificador único de la orden asignado por el comercio.
`amount`	Monto total de la orden.
`currency`	Código de moneda según el estándar ISO 4217.
installments	Detalles sobre el pago a plazos.	Opcional, si no se envía la transacción, se procesará sin cuotas ni pagos diferidos.
initialDiferement	Diferimiento inicial.
numberInstallments	Número de cuotas.
planType	Tipo de plan de pago (“0” para plan regular).

Ejemplo de respuesta exitosa:

Http code 200

{
  "id": "5c51bebd-5b21-4ef3-b980-d41eb0b83568",
  "order": {
    "merchantOrderId": "9a6ecf36-8265-11ee-b962-0242ac120002",
    "amount": "100.00",
    "currency": "484"
  },
  "payload": {
    "paymentId": "4d0cbd45-bc39-4d17-96ef-34affa296bde",
    "responseCode": "00",
    "responseDescription": "Approved or completed successfully (if balances are available)",
    "authorizationNumber": "280188",
    "referenceNumber": "000027389440",
    "status": "Paid"
  },
  "isApproved": true,
  "isFailure": false,
  "errors": null
}

Descripción de campos

Campo	Descripción
`id`	Id único de la transacción asignado por la pasarela de pagos.
`order`	Contiene detalles sobre la orden de compra.
`merchantOrderId`	Identificador único de la orden asignado por el comercio.
`amount`	Monto total de la orden.
`currency`	Código de moneda según el estándar ISO 4217.
`payload`	Contiene información detallada sobre la transacción.
`paymentId`	Identificador único de la transacción de pago.
`responseCode`	Código de respuesta que indica el resultado de la transacción (en este caso, "00" indica aprobación).
`responseDescription`	Descripción asociada al código de respuesta.
`authorizationNumber`	Número de autorización de la transacción.
`referenceNumber`	Número de referencia asociado a la transacción.
`status`	Estado de la transacción, en este caso, "Paid" indica que la transacción ha sido completada con éxito.
`isApproved`	Indica si la transacción fue aprobada. En este ejemplo, es “true”, lo que significa que la transacción fue aprobada.
`isFailure`	Indica si la transacción ha fallado. En este ejemplo, es “false”, indicando que la transacción no ha fallado.
`errors`	Contiene detalles como número de error y una descripción, si los hubiera. En este caso, es “null”, lo que significa que no se han producido errores en la transacción.