Crear solicitud y/o link de cobro

POST https://payment-backend-sandbox.milio.com.co/cross-border/v1/link

Este endpoint permite crear una solicitud de cobro, donde se puede enviar dinero a otra persona. La solicitud puede incluir un link de pago o no, dependiendo de si se incluye el parámetro link. Si se incluye, el sistema generará un enlace único para que el destinatario pueda realizar el pago.

Body

Card

JSON

{
    "amount": 500000,
    "currency": "COP",
    "thirdUUID": "b1f66247-b235-49e8-89f3-d44db2adea19",
    "paymentMethod": {
        "cardNumber": "{{card1}}",
        "cardExpiryDate": "12/50",
        "cardCVV": "123",
        "cardName": "{{$randomFirstName}} {{$randomLastName}}"
     },
    "reference": "Birthday 🎁",
    "link": true
}

Token

JSON

{
    "amount": 500000,
    "currency": "COP",
    "thirdUUID": "b1f66247-b235-49e8-89f3-d44db2adea19",
    "thirdBankUUID": "e6347335-b766-44c4-946e-752170274b7c",
    "reference": "Birthday 🎁"
}

Para más información de las divisas

Campo	Tipo	Obligatorio	Descripción
amount	number	Sí	Monto a solicitar o cobrar.
currency	string	Sí	Código de moneda ISO (por ejemplo, "COP").
thirdUUID	string (UUID)	Sí	UUID del tercero destinatario del pago.
thirdBankUUID	string (UUID)	No*	UUID opcional de la entidad tarejta asociada al tercero.
paymentMethod	object	No*	Datos de la tarjeta para pago manual (opcional si no existe una tarjeta tokenizada o si no se quiere tokenizar).
cardNumber	string	Si paymentMethod se envía	Número de la tarjeta de crédito o débito.
cardExpiryDate	string	Si paymentMethod se envía	Fecha de expiración en formato MM/YY.
cardCVV	string	Si paymentMethod se envía	Código de seguridad CVV de la tarjeta.
cardName	string	Si paymentMethod se envía	Nombre completo del titular de la tarjeta.
reference	string	No	Nota o referencia descriptiva para identificar la solicitud.
link	boolean	No	Si es true, genera un link de pago para compartir; si es false o se omite, no se genera.

Respuesta

JSON

{
    "error": 0,
    "code": "ML000",
    "category": "GENERAL",
    "message": "Operación completada con éxito.",
    "data": {
        "id": "5ea4ac45-0a46-4505-9feb-0c075095e99f",
        "link": "https://cross-border.milio.com.co/v1/ebaa7c1f", //Opcional
        "reference": "Birthday 🎁"
    }
}