Generar key token

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.

Casos

1. Registrar tarjeta a tercero

{
    "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

{
    "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)

Beneficiario no registrado

{
   "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

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

Beneficiario registrado con tarjeta tokenizada

{
   "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
`recipientUUID`	UUID del beneficiario. Solo se incluye cuando save = true. (Opcional)
recipientCardUUID	UUID de la tarjeta del beneficiario. Solo se incluye cuando save = true. (Opcional)
lasFourDigits	Últimos 4 dígitos de la tarjeta del beneficiario. Solo se incluye cuando save = true. (Opcional)
franchise	Franquicia de la tarjeta del beneficiario (por ejemplo: VISA,). Solo se incluye cuando save = true. (Opcional)