post
https://payment-backend-sandbox.milio.com.co/api-vdc-payment/v1/send-payout
Endpoint para enviar pagos a una cuenta de destino. Permite transferir fondos a la cuenta de un beneficiario, procesando la solicitud de pago de forma segura
Request
| Sección | Campo | Tipo | Descripción | Obligatoriedad |
|---|---|---|---|---|
| transactionDetail | transactionAmount | number (double) | Monto de la transacción. | Requerido |
| transactionDetail | transactionCurrencyCode | string (3) | Código de moneda de la transacción (ISO-4217) Alpha-3. | Requerido |
| transactionDetail | additionalData[].name | string | Nombre del dato adicional. | Opcional |
| transactionDetail | additionalData[].value | string | Valor asociado al dato adicional. | Opcional |
| transactionDetail | purposeOfPayment | string | Propósito del pago. | Condicional |
| transactionDetail | quoteId | integer | Identificador de la cotización aplicada. | Opcional |
| transactionDetail | senderSourceOfFunds | string | Fuente de los fondos del remitente. | Condicional |
| transactionDetail | settlementCurrencyCode | string (3) | Código de moneda de liquidación (ISO-4217) Alpha-3. | Requerido |
| transactionDetail | statementNarrative | string | Descripción que aparece en el estado de cuenta del beneficiario. | Condicional |
| transactionDetail | isSamePerson | boolean | Indica si el remitente y el beneficiario corresponden a la misma persona. Por defecto es false | Requerido |
| senderDetail | type | string | Tipo de remitente, “I” para Individual y “C” para Empresa. Por defecto es 'I' | Requerido |
| senderDetail | senderReferenceNumber | [ 1 .. 33 ] | Identificador único del remitente utilizado para rastrear y referenciar la transacción.. | Condicional |
| senderDetail | firstName | string [1..35] | Nombre(s) del remitente. | Condicional |
| senderDetail | lastName | string [1..35] | Apellido(s) del remitente. | Condicional |
| senderDetail | fullName | string [1..70] | Nombre completo del remitente. | Condicional |
| senderDetail | address.addressLine1 | string [1..50] | Dirección principal del remitente. | Condicional |
| senderDetail | address.addressLine2 | string [1..50] | Línea adicional de la dirección del remitente. | Opcional |
| senderDetail | address.city | string [1..35] | Ciudad de residencia del remitente. | Condicional |
| senderDetail | address.state | string [1..25] | Estado o provincia de residencia del remitente. | Opcional |
| senderDetail | address.postalCode | string [1..16] | Código postal de la dirección del remitente. | Opcional |
| senderDetail | address.country | string (3) | Código de país de la dirección del remitente (ISO-3166 Alpha-3). | Condicional |
| senderDetail | additionalData[].name | string [1..35] | Nombre del campo adicional del remitente. | Opcional |
| senderDetail | additionalData[].value | string [1..100] | Valor del campo adicional del remitente. | Opcional |
| senderDetail | cityOfBirth | string [1..35] | Ciudad de nacimiento del remitente. | Opcional |
| senderDetail | countryOfBirth | string (3) | País de nacimiento del remitente (ISO-3166 Alpha-3). | Condicional |
| senderDetail | dateOfBirth | string (YYYY-MM-DD) | Fecha de nacimiento del remitente. | Condicional |
| senderDetail | identificationList[].idIssueCountry | string (3) | País emisor del documento de identificación. | Condicional |
| senderDetail | identificationList[].idNumber | string [1..35] | Número de identificación del remitente. | Condicional |
| senderDetail | identificationList[].typeDocumentId | string | Tipo de identificación del remitente. | Condicional |
| senderDetail | contactEmail | string [1..210] | Correo electrónico del remitente. | Opcional |
| senderDetail | contactNumber | string [1..16] | Número de contacto del remitente. | Opcional |
| senderDetail | contactNumberType | string | Tipo de número de contacto del remitente. | Opcional |
| senderDetail | senderAccountNumber | string | Número de cuenta del remitente. | Condicional |
| recipientDetail | type | string | Tipo de beneficiario, “I” para Individual y “C” para Empresa. Por defecto es 'I' | Requerido |
| recipientDetail | firstName | string [1..35] | Nombre(s) del beneficiario. | Condicional |
| recipientDetail | lastName | string [1..35] | Apellido(s) del beneficiario. | Condicional |
| recipientDetail | fullName | string [1..70] | Nombre completo del beneficiario. | Condicional |
| recipientDetail | bank.accountName | string [1..70] | Nombre del titular de la cuenta bancaria del beneficiario. | Condicional |
| recipientDetail | bank.accountNumber | string [1..254] | Número de cuenta bancaria del beneficiario. | Condicional |
| recipientDetail | bank.accountNumberType | string | Tipo de número de cuenta del beneficiario. | Condicional |
| recipientDetail | bank.accountType | string | Tipo de cuenta bancaria del beneficiario. | Condicional |
| recipientDetail | bank.countryCode | string (3) | Código de país del banco del beneficiario (ISO-3166 Alpha-3). | Condicional |
| recipientDetail | bank.currencyCode | string (3) | Código de moneda de la cuenta del beneficiario (ISO-4217 Alpha-3). | Condicional |
| recipientDetail | bank.bankCode | string [1..12] | Código identificador del banco del beneficiario. | Condicional |
| recipientDetail | bank.bankCodeType | string | Tipo de código bancario utilizado. | Condicional |
| recipientDetail | bank.bankName | string [1..50] | Nombre del banco del beneficiario. | Opcional |
| recipientDetail | bank.BIC | string [8..11] | Código BIC/SWIFT del banco del beneficiario. | Condicional |
| recipientDetail | bank.branchCode | string [1..12] | Código de sucursal bancaria del beneficiario. | Opcional |
| recipientDetail | additionalData[].name | string [1..35] | Nombre del campo adicional del beneficiario. | Opcional |
| recipientDetail | additionalData[].value | string [1..100] | Valor del campo adicional del beneficiario. | Opcional |
| recipientDetail | address.addressLine1 | string [1..50] | Dirección principal del beneficiario. | Condicional |
| recipientDetail | address.addressLine2 | string [1..50] | Línea adicional de la dirección del beneficiario. | Opcional |
| recipientDetail | address.city | string [1..35] | Ciudad de residencia del beneficiario. | Condicional |
| recipientDetail | address.state | string [1..25] | Estado o provincia de residencia del beneficiario. | Condicional |
| recipientDetail | address.postalCode | string [1..16] | Código postal de la dirección del beneficiario. | Condicional |
| recipientDetail | address.country | string (3) | Código de país de la dirección del beneficiario (ISO-3166 Alpha-3). | Condicional |
| recipientDetail | cityOfBirth | string [1..35] | Ciudad de nacimiento del beneficiario. | Opcional |
| recipientDetail | countryOfBirth | string (3) | País de nacimiento del beneficiario (ISO-3166 Alpha-3). | Condicional |
| recipientDetail | dateOfBirth | string (YYYY-MM-DD) | Fecha de nacimiento del beneficiario. | Condicional |
| recipientDetail | identificationList[].idIssueCountry | string (3) | País emisor del documento de identificación. | Condicional |
| recipientDetail | identificationList[].idNumber | string [1..35] | Número de identificación del beneficiario. | Condicional |
| recipientDetail | identificationList[].typeDocumentId | string | Tipo de identificación del beneficiario. | Condicional |
| recipientDetail | contactEmail | string [1..210] | Correo electrónico de contacto del beneficiario. | Opcional |
| recipientDetail | contactNumber | string [1..16] | Número de contacto del beneficiario. | Opcional |
| recipientDetail | contactNumberType | string | Tipo de número de contacto del beneficiario. | Opcional |
Ejemplo
Usuario nuevo
{
"transactionDetail": {
"transactionAmount": 10,
"transactionCurrencyCode": "GBP",
"senderSourceOfFunds": "01",
"settlementCurrencyCode": "GBP"
},
"recipientDetail": {
"type": "I",
"lastName": "Bharath",
"firstName": "Anand",
"contactNumberType": "MOBILE",
"contactEmail": "[email protected]",
"contactNumber": "+123456789",
"bank": {
"accountName": "Money Market",
"accountNumber": "6970093",
"accountNumberType": "DEFAULT",
"countryCode": "GBR",
"currencyCode": "GBP"
},
"identificationList": [
{
"typeDocumentId": 3,
"idNumber": "P128766Z",
"idIssueCountry": "GBR"
}
]
},
"senderDetail": {
"type": "I",
"senderReferenceNumber": "4304630005267011",
"lastName": "Russel",
"firstName": "Saha",
"contactNumberType": "MOBILE",
"contactEmail": "[email protected]",
"contactNumber": "+123456789",
"address": {
"addressLine1": "1600 Pennsylvania Ave",
"city": "Manchester",
"country": "GBR",
"postalCode": "20500"
},
"identificationList": [
{
"typeDocumentId": 5,
"idNumber": "P128766Z",
"idIssueCountry": "GBR"
}
]
}
}
Tercero y credencial existente
{
"transactionDetail": {
"transactionAmount": 1551,
"transactionCurrencyCode": "GBP",
"settlementCurrencyCode": "GBP"
},
"recipientUuid": "c05909ee-9910-4dcb-91eb-b066675b866c",
"recipientDetail": {
"type": "I",
"paymentMethodUUID": "378908e7-2845-44ee-8b88-99a6da3178b1"
},
"senderUuid": "bbce86b8-6247-41bf-89f2-1542d7086253",
"senderDetail": {
"type": "I"
}
}
Tercero existente y credencial nueva
{
"transactionDetail": {
"transactionAmount": 1551,
"transactionCurrencyCode": "GBP",
"settlementCurrencyCode": "GBP"
},
"recipientUuid": "c05909ee-9910-4dcb-91eb-b066675b866c",
"recipientDetail": {
"type": "I",
"bank": {
"accountName": "Money Market",
"accountNumber": "6970093",
"accountNumberType": "DEFAULT",
"countryCode": "GBR",
"currencyCode": "GBP"
}
},
"senderUuid": "bbce86b8-6247-41bf-89f2-1542d7086253",
"senderDetail": {
"type": "I"
}
}
