Inicio de transacción

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/begin-transaction
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",
    "styleId": "style1",
    "urlNotification": "https://dominiocomercion/notificacionResultado",
    "order": {
        "merchantOrderId": "9a6ecf36-8265-11ee-b962-0242ac120002",
        "amount": "100.00",
        "currency": "484"
    },
    "recurringPayment": {
        "saveCardOnfile": true
    }   
}

Descripción de Campos

Campo	Descripción	Nota
`transactionType`	Indica el tipo de transacción. En este caso, debe ser "sale" o "preauth".
`merchantId`	Identificador único del comerciante en la pasarela de pago, es asignado al momento de crear la cuenta.
`terminalId`	Identificador único de la terminal ,es asignado al momento de crear la cuenta.
`styleId`	Id del estilo que sea desea aplicar a la carta de pago, pudiendo ser alguno predeterminado o personalizado con archivo CSS a la necesidad del comercio.
`urlNotification`	URL proporcionada por el comercio en donde se notifica el resultado.
`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.
`recurringPayment`	Configuración para pagos recurrentes.	Opcional, si no se envía el valor predeterminado es “false”.
`saveCardOnfile`	Indica si se debe guardar la tarjeta en archivo para futuras transacciones.

Ejemplo de respuesta exitosa

Http code 200

{
  "id": "5c51bebd-5b21-4ef3-b980-d41eb0b83568",
  "url": "https://{TODOdominio}/{proxy+}",
  "integrity":"sha256-wiOdhYVfjuy3F0XwBIOtPqWfhN65naUwczrtjnkABys="
}

Descripción de campos

Campo	Descripción
`id`	Id único de la transacción asignado por la pasarela de pagos, se usa en la carta de pago.
`url`	URL que se utiliza en el script de carta de pago.
`integrity`	Cadena de caracteres que se utiliza para validar la integridad del script.