Finalizar transacción v1

POST https://payment-backend-sandbox.milio.com.co/sdk-widget/pay-transfer/v1

Este endpoint permite confirmar y completar una transacción previamente iniciada. Para ello, se requiere el hash de la tarjeta tokenizada, junto con el monto y la divisa de la operación.

Además, el endpoint permite establecer el remitente (sender) que realizará la transferencia, asociando su tarjeta tokenizada como fuente de los fondos.

📘

Todos los datos enviados al endpoint deben ser encriptados antes de ser transmitidos, igualmente la respuesta debe ser desencriptada.

Antes de realizar la petición, asegúrate de haber configurado correctamente las llaves de encriptación y desencriptación utilizadas para proteger los datos sensibles.
Puedes consultar el proceso detallado en la siguiente guía:

Gestión de llaves para encriptación de datos

Ejemplo de Request (JavaScript)

JavaScript

const axios = require('axios');
let data = JSON.stringify({
  "data": "data encriptada"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://payment-backend-sandbox.milio.com.co/sdk-widget/pay-transfer/v1',
  headers: { 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer eyJhbGciOiJI...'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Funcionalidades clave:

• Ejecuta la transferencia final utilizando una tarjeta previamente tokenizada.
• Permite especificar el monto y la divisa de forma explícita.
• Define el remitente que enviará los fondos en la operación (en el flujo que corresponda).

Ejemplo

1. Si la operación es Cross Border

1.1 Divisa destinatario

Body

{
   "sourceCurrencyCode":"USD",
   "destinationCurrencyCode":"COP",
   "destinationAmount":100000,
   "transactionReasons":"Remesa familiar"
}

1.2 Divisa remitente

Body

{
   "sourceCurrencyCode":"USD",
   "destinationCurrencyCode":"COP",
   "sourceAmount":150,
   "transactionReasons":"Remesa familiar sandb"
}

2. Si la operación es local

Body

{
    "sourceCurrencyCode": "USD",
    "sourceAmount": 150
}

3. Si la operación requiere el remitente

JSON

{
    "fx": {
        "sourceCurrencyCode": "USD",
        "destinationCurrencyCode": "COP",
        "destinationAmount": 100000
    },
    "senderUUID": "...",
    "senderCardUUID": "..."
}

Campos de respuesta

Campo	Descripción
data	Datos del resultado de la operación
message	Mensaje descriptivo del resultado de la operación.

Nota

A través del webhook proporcionado se recibe el key, el cual se utiliza en el encabezado de la petición.