Generar key token v1

POST https://payment-backend-sandbox.milio.com.co/sdk-widget/create-enrollment/v1

Este endpoint permite generar un token de acceso para activar y ejecutar el SDK web de Milio. El SDK web debe ser inyectado previamente en el cliente. Dependiendo de la configuración, el token generado puede ser utilizado para múltiples propósitos.

La clave generada proporciona acceso al SDK web para realizar diversas operaciones de pago o interactuar con los servicios de Milio según la configuración establecida.

📘

Todos los datos enviados al endpoint deben ser encriptados antes de ser transmitidos.

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-mobile',
  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);
});

Casos

1. Registrar tarjeta a tercero

JSON

{
    "type": "CARD_REGISTRATION",
    "webhook": "https://webhook-test.com/2c06f6088efb0aa72ef3ac72a174507a",
    "thirdUUID": "cd7.."
}

PARÁMETRO	DESCRIPCIÓN
type	Tipo de operación
webhook	URL de confirmación de enrolamiento de tarjeta
thirdUUID	Id del tercero

2. One-time disbursement - Pagos Directos Locales y Cross-Border

2. Casos de uso SDK OTD .
3. Guía de integración.

JSON

{
    "type": "ENROLLMENT_PAYOUT_DIRECT",
    "reference": "{{$guid}}", // Your id or identification for transaction
    "senderUUID": "{{third-xborder}}",
    "senderCardUUID": "{{thirdBankUUID}}",
    "recipient": {
        "name": "Andres",
        "lastName": "Navarro",
        "document": "10...",
        "email": "[email protected]",
        "dateOfBirth":"1995-12-10",
        "indicativeContact": "+57",
        "phoneContact": "...",        
        "addressData":{
            "street":"calle 35 cr3aw #34-64",
            "city":"Pasto",
            "region":"CO-NAR",
            "postal_code":"520002",
            "country":"CO"
        }        
    },
    "fullData": false,
    "webhook": "https://webhook-test.com/5f1a3ef2b2090773083e90128919cd6a"
}

Campo	Descripción
type	Tipo de operación.
reference	Identificador único de la transacción.
senderUUID	UUID del remitente (identificador único).
senderCardUUID	UUID de la tarjeta del sender.
recipient.name	Nombre del destinatario del pago.
recipient.lastName	Apellido del destinatario.
recipient.document	Número de documento de identificación del destinatario.
recipient.email	Correo electrónico del destinatario.
recipient.dateOfBirth	Fecha de nacimiento del destinatario (formato YYYY-MM-DD).
recipient.indicativeContact	Indicativo telefónico del destinatario.
recipient.phoneContact	Número de teléfono del destinatario.
recipient.addressData.street	Calle del destinatario.
recipient.addressData.city	Ciudad del destinatario.
recipient.addressData.region	Región o estado del destinatario.
recipient.addressData.postal_code	Código postal del destinatario.
recipient.addressData.country	País del destinatario.
fullData	Indica si se deben proporcionar todos los datos de la tarjeta del destinatario (true/false).
save	Indica si se desea guardar el beneficiario (recipient).
webhook	URL del webhook donde se recibirán notificaciones de la transacción.

3. One-time disbursement - Pagos Directos Locales y Cross-Border (Flipped)

2. Casos de uso SDK OTD .
3. Guía de integración.

Beneficiario no registrado

JSON

{
   "type":"ENROLLMENT_PAYOUT_DIRECT_FLIPPED",
   "reference":"...",
   "webhook":"https://...",
   "fullData":false,
   "save":true,
   "externalId":"..",
   "recipient":{
      "name":"Andres",
      "lastName":"navarro",
      "document":"...",
      "email":"...",
      "dateOfBirth":"1995-12-10",
      "indicativeContact":"+57",
      "phoneContact":"..",
      "addressData":{
         "street":"calle 35 cr3aw #34-64",
         "city":"Monteria",
         "region":"CO-COR",
         "postal_code":"23001",
         "country":"CO"
      }
   }
}

Beneficiario registrado con nueva tarjeta

JSON

{
   "type":"ENROLLMENT_PAYOUT_DIRECT_FLIPPED",
   "reference":"...",
   "webhook":"https://...",
   "fullData":false,
   "recipientUUID":"..."
}

Beneficiario registrado con tarjeta tokenizada

JSON

{
   "type":"ENROLLMENT_PAYOUT_DIRECT_FLIPPED",
   "reference":"...",
   "webhook":"https://...",
   "fullData":false,
   "recipientUUID":"...",
   "recipientCardUUID":"..."
}

Campo	Descripción
type	Tipo de operación.
reference	Identificador único de la transacción.
recipientUUID	UUID del beneficiario (identificador único).
recipientCardUUID	UUID de la tarjeta del beneficiario.
externalId	Identificador único de la compañía para relacionarlo con el remitente
recipient.name	Nombre del destinatario del pago.
recipient.lastName	Apellido del destinatario.
recipient.document	Número de documento de identificación del destinatario.
recipient.email	Correo electrónico del destinatario.
recipient.dateOfBirth	Fecha de nacimiento del destinatario (formato YYYY-MM-DD).
recipient.indicativeContact	Indicativo telefónico del destinatario.
recipient.phoneContact	Número de teléfono del destinatario.
recipient.addressData.street	Calle del destinatario.
recipient.addressData.city	Ciudad del destinatario.
recipient.addressData.region	Región o estado del destinatario.
recipient.addressData.postal_code	Código postal del destinatario.
recipient.addressData.country	País del destinatario.
fullData	Indica si se deben proporcionar todos los datos de la tarjeta del destinatario (true/false).
webhook	URL del webhook donde se recibirán notificaciones de la transacción.

Campos de respuesta

Campo	Descripción
key	Token temporal, el cual se inserta en el SDK.
message	Mensaje descriptivo del resultado de la operación.
reference	Referencia de la transacción
thirdUUID	Cuando se save = true se entrega el uuid del beneficiario. (Opcional)