post
https://payment-backend-sandbox.milio.com.co/api-vdc-payment/v1/validate-payout
Este endpoint permite validar la estructura y consistencia del payload de un payout hacia cuentas bancarias antes de enviar la transacción para su procesamiento.
La validación ayuda a identificar errores de formato, campos obligatorios y reglas básicas, reduciendo rechazos y mejorando la probabilidad de éxito del payout.
Este endpoint no ejecuta el pago; únicamente valida la solicitud conforme a los lineamientos de Visa. Los nombres de campos ISO se utilizan como referencia.
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 | settlementCurrencyCode | string (3) | Código de moneda de liquidación (ISO-4217) Alpha-3. | Requerido |
| transactionDetail | senderSourceOfFunds | string | Fuente de los fondos del remitente. | Condicional |
| transactionDetail | purposeOfPayment | string | Propósito del pago. | Condicional |
| transactionDetail | senderBeneficiaryRelationship | string | Relación entre el remitente y el beneficiario. | Opcional |
| transactionDetail | payoutSpeed | string | Velocidad de procesamiento del payout. | Opcional |
| transactionDetail | paymentRail | string | Red o riel de pago utilizado para la validación. | Opcional |
| transactionDetail | quoteId | integer | Identificador de la cotización aplicada. | Opcional |
| transactionDetail | statementNarrative | string | Descripción que se mostraría en el estado de cuenta. | Condicional |
| senderDetail | type | string | Tipo de remitente. | Requerido |
| 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 | dateOfBirth | string (YYYY-MM-DD) | Fecha de nacimiento del remitente. | Condicional |
| senderDetail | cityOfBirth | string [1..35] | Ciudad de nacimiento del remitente. | Opcional |
| senderDetail | countryOfBirth | string (3) | País de nacimiento del remitente (ISO-3166). | Condicional |
| senderDetail | identificationType | string | Tipo de identificación del remitente. | Condicional |
| senderDetail | identificationNumber | string [1..35] | Número de identificación del remitente. | Condicional |
| senderDetail | identificationIssuingCountry | string (3) | País emisor del documento de identificación. | 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 | 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 del remitente. | Opcional |
| senderDetail | address.country | string (3) | País de residencia del remitente (ISO-3166). | 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 |
| recipientDetail | type | string | Tipo de beneficiario. | 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 | dateOfBirth | string (YYYY-MM-DD) | Fecha de nacimiento del beneficiario. | Condicional |
| recipientDetail | cityOfBirth | string [1..35] | Ciudad de nacimiento del beneficiario. | Opcional |
| recipientDetail | countryOfBirth | string (3) | País de nacimiento del beneficiario (ISO-3166). | Condicional |
| recipientDetail | identificationType | string | Tipo de identificación del beneficiario. | Condicional |
| recipientDetail | identificationNumber | string [1..35] | Número de identificación del beneficiario. | Condicional |
| recipientDetail | identificationIssuingCountry | string (3) | País emisor del documento de identificación. | 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 |
| 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) | País de residencia del beneficiario (ISO-3166). | Condicional |
| 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 | bank.countryCode | string (3) | Código de país del banco del beneficiario (ISO-3166). | Condicional |
| recipientDetail | bank.currencyCode | string (3) | Código de moneda de la cuenta del beneficiario (ISO-4217). | 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 | 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 |