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