post https://payment-backend-sandbox.milio.com.co/external-opetarion/payment
El endpoint para realizar depósitos (cash-in) permite a los clientes ingresar fondos a sus cuentas. A continuación se presenta la estructura detallada del cuerpo de la solicitud (payload) y la explicación de cada parámetro.
Objeto Json
{
"payment": {
"operation": "CASH_IN", //'CASH_IN' | 'CASH_OUT'
"currency": "COP", // 'USD' | 'COP'
"description": "paytop",
"amount": 50000
},
"sender": {
"fullName": "Juan Luis Perez",
"typeDocument": "CC",
"document": "4551512315",
"credentials": {
"cardName": "John Doe",
"accountNumber": "1234567812345678",
"expirationDate": "12/25",
"cvv": "123",
"address": "123 Main St, City, Country"
}
},
"recipient": {
"fullName": "Juan Luis Perez",
"typeDocument": "CC",
"document": "4551512315",
"credentials": {
"cardName": "Jane Smith",
"accountNumber": "8765432187654321",
"expirationDate": "11/26",
"address": "456 Elm St, City, Country"
}
}
}
PARÁMETRO | DESCRIPCIÓN |
---|---|
payment.operation | Tipo de operación. Debe ser 'CASH_IN' o 'CASH_OUT'. |
payment.currency | Moneda de la transacción. Puede ser 'USD' o 'COP'. |
payment.description | Descripción de la transacción. En este ejemplo, es 'paytop'. |
payment.amount | Monto del depósito. En este ejemplo, es 50000. |
sender.fullName | Nombre completo del remitente. Ejemplo: 'Juan Luis Perez'. |
sender.typeDocument | Tipo de documento del remitente. Ejemplo: 'CC'. |
sender.document | Número de documento del remitente. Ejemplo: '4551512315'. |
sender.credentials.cardName | Nombre del titular de la tarjeta de quien envía los fondos. Ejemplo: 'John Doe'. |
sender.credentials.accountNumber | Número de la tarjeta de quien envía los fondos. Ejemplo: '1234567812345678'. |
sender.credentials.expirationDate | Fecha de expiración de la tarjeta en formato 'MM/YY'. Ejemplo: '12/25'. |
sender.credentials.cvv | Código de seguridad de la tarjeta. Ejemplo: '123'. |
sender.credentials.address | Dirección del titular de la tarjeta. Ejemplo: '123 Main St, City, Country'. |
recipient.fullName | Nombre completo del destinatario. Ejemplo: 'Juan Luis Perez'. |
recipient.typeDocument | Tipo de documento del destinatario. Ejemplo: 'CC'. |
recipient.document | Número de documento del destinatario. Ejemplo: '4551512315'. |
recipient.credentials.cardName | Nombre del titular de la tarjeta de quien recibe los fondos. Ejemplo: 'Jane Smith'. |
recipient.credentials.accountNumber | Número de la tarjeta de quien recibe los fondos. Ejemplo: '8765432187654321'. |
recipient.credentials.expirationDate | Fecha de expiración de la tarjeta en formato 'MM/YY'. Ejemplo: '11/26'. |
recipient.credentials.address | Dirección del titular de la tarjeta. Ejemplo: '456 Elm St, City, Country' |
El endpoint de cash-in permite la entrada de efectivo mediante la transferencia de fondos de una tarjeta de crédito o débito del remitente a la tarjeta de crédito o débito del destinatario.
Es esencial proporcionar todos los detalles correctamente para asegurar una transacción exitosa y segura. Este proceso es una parte integral de la gestión de efectivo en la plataforma, permitiendo a los usuarios añadir fondos de manera eficiente.