API Reference

Crear solicitud y/o link de cobro

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

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

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

CampoTipoObligatorioDescripción
amountnumberMonto a solicitar o cobrar.
currencystringCódigo de moneda ISO (por ejemplo, "COP").
thirdUUIDstring (UUID)UUID del tercero destinatario del pago.
thirdBankUUIDstring (UUID)No*UUID opcional de la entidad tarejta asociada al tercero.
paymentMethodobjectNo*Datos de la tarjeta para pago manual (opcional si no existe una tarjeta tokenizada o si no se quiere tokenizar).
   cardNumberstringSi paymentMethod se envíaNúmero de la tarjeta de crédito o débito.
   cardExpiryDatestringSi paymentMethod se envíaFecha de expiración en formato MM/YY.
   cardCVVstringSi paymentMethod se envíaCódigo de seguridad CVV de la tarjeta.
   cardNamestringSi paymentMethod se envíaNombre completo del titular de la tarjeta.
referencestringNoNota o referencia descriptiva para identificar la solicitud.
linkbooleanNoSi es true, genera un link de pago para compartir; si es false o se omite, no se genera.

Respuesta

{
    "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 🎁"
    }
}
Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!