Payouts
1
Step 1: Retrieve Payout Gateway ID
To make a payout, first retrieve the available payout methods for a specific country:
GET {{host}}/payment-methods/payout?country={{country_iso3_code}}
Request examples:
GET {{host}}/payment-methods/payout?country=CHL GET {{host}}/payment-methods/payout?country=COL GET {{host}}/payment-methods/payout?country=PER GET {{host}}/payment-methods/payout?country=ARG GET {{host}}/payment-methods/payout?country=MEX
Response examples:
Argentina
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 3,
"method_name": "PayPal",
"country": "ARG",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 26,
"method_name": "Volet(Advcash)",
"country": "ARG",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 64,
"method_name": "Mastercard",
"country": "ARG",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 122,
"method_name": "Visa",
"country": "ARG",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 492,
"method_name": "Bank Transfer",
"country": "ARG",
"currency": "ARS",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
]
}Chile
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 7,
"method_name": "PayPal",
"country": "CHL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 29,
"method_name": "Volet(Advcash)",
"country": "CHL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 67,
"method_name": "Mastercard",
"country": "CHL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 125,
"method_name": "Visa",
"country": "CHL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 505,
"method_name": "Bank Transfer",
"country": "CHL",
"currency": "CLP",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "CLP",
"exchange_rate_float": null
},
{
"id": 508,
"method_name": "Bank Transfer",
"country": "CHL",
"currency": "CLP",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "CLP",
"exchange_rate_float": null
}
]
}Colombia
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 2,
"method_name": "Bank Transfer",
"country": "COL",
"currency": "COP",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 8,
"method_name": "PayPal",
"country": "COL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 30,
"method_name": "Volet(Advcash)",
"country": "COL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 68,
"method_name": "Mastercard",
"country": "COL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 126,
"method_name": "Visa",
"country": "COL",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
]
}Mexico
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 1,
"method_name": "SPEI",
"country": "MEX",
"currency": "MXN",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 18,
"method_name": "PayPal",
"country": "MEX",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 37,
"method_name": "Volet(Advcash)",
"country": "MEX",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 75,
"method_name": "Mastercard",
"country": "MEX",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 133,
"method_name": "Visa",
"country": "MEX",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
]
}Peru
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 21,
"method_name": "PayPal",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 41,
"method_name": "Volet(Advcash)",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 79,
"method_name": "Mastercard",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 137,
"method_name": "Visa",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 190,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "usd",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 501,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "PEN",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 502,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 506,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "USD",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
},
{
"id": 507,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "PEN",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "PEN",
"exchange_rate_float": null
}
]
}Extract the id of the desired payment method to proceed.
2
Step 2: Retrieve Payment details form
Use the retrieved gateway_id to get the form fields required for beneficiary payment details:
GET {{host}}/beneficiary/form/show/{{gateway_id}}
Request examples:
Argentina GET {{host}}/beneficiary/form/show/492
Chile GET {{host}}/beneficiary/form/show/505
Colombia GET {{host}}/beneficiary/form/show/2
Mexico GET {{host}}/beneficiary/form/show/1
Peru GET {{host}}/beneficiary/form/show/501
Response examples:
Argentina
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"payment_data": [
{
"type": "select",
"name": "Tipo",
"key": "beneficiary_type",
"options": [
{
"value": "Corporate",
"label": "Corporativo"
},
{
"value": "Individual",
"label": "Natural"
}
]
},
{
"type": "text",
"name": "Nombres",
"key": "beneficiary_first_name",
"min": 3,
"max": 50,
"when": {
"key": "beneficiary_type",
"value": "Individual"
}
},
{
"type": "text",
"name": "Apellidos",
"key": "beneficiary_last_name",
"min": 3,
"max": 50,
"when": {
"key": "beneficiary_type",
"value": "Individual"
}
},
{
"type": "text",
"name": "Nombre de empresa",
"key": "company_name",
"min": 4,
"max": 50,
"when": {
"key": "beneficiary_type",
"value": "Corporate"
}
},
{
"type": "email",
"name": "Correo",
"key": "beneficiary_email",
"max": 80
},
{
"type": "text",
"name": "Dirección",
"key": "beneficiary_address",
"min": 3,
"max": 200
},
{
"type": "select",
"name": "Tipo de documento",
"key": "beneficiary_document_type",
"options": [
{
"value": "CUIL",
"label": "Código único de identificación laboral"
},
{
"value": "CUIT",
"label": "Código único de identificación tributaria"
}
]
},
{
"type": "text",
"name": "CUIL/CUIT",
"key": "beneficiary_document_number",
"min": 11,
"max": 11
},
{
"type": "select",
"name": "Banco",
"key": "bank_code",
"options": [
{
"value": "956",
"label": "Mercado pago"
},
{
"value": "125",
"label": "Banco santander rio"
},
{
"value": "90",
"label": "Banco de galicia y buenos aires"
},
{
"value": "76",
"label": "A.b.n amro bank"
},
{
"value": "77",
"label": "American express bank ltd"
},
{
"value": "78",
"label": "Bacs banco de credito y securitizacion"
},
{
"value": "79",
"label": "Banca nazionale del lavoro"
},
{
"value": "80",
"label": "Banco b. i. creditanstalt"
},
{
"value": "81",
"label": "Banco bradesco argentina"
},
{
"value": "82",
"label": "Banco cetelem argentina"
},
{
"value": "83",
"label": "Banco cmf"
},
{
"value": "84",
"label": "Banco cofidis"
},
{
"value": "85",
"label": "Banco columbia"
},
{
"value": "86",
"label": "Banco comafi"
},
{
"value": "87",
"label": "Banco credicoop coop. l"
},
{
"value": "88",
"label": "Banco de corrientes"
},
{
"value": "89",
"label": "Banco de formosa"
},
{
"value": "91",
"label": "Banco de inversion y comercio exterior"
},
{
"value": "92",
"label": "Banco de la ciudad de buenos aires"
},
{
"value": "93",
"label": "Banco de la nacion argentina"
},
{
"value": "94",
"label": "Banco de la pampa sociedad de economia m"
},
{
"value": "95",
"label": "Banco de la provincia de buenos aires"
},
{
"value": "96",
"label": "Banco de la provincia de cordoba"
},
{
"value": "97",
"label": "Banco de la republica oriental del uruguay"
},
{
"value": "104",
"label": "Banco del chubut"
},
{
"value": "105",
"label": "Banco del sol"
},
{
"value": "106",
"label": "Banco del tucuman"
},
{
"value": "98",
"label": "Banco de san juan"
},
{
"value": "99",
"label": "Banco de santa cruz"
},
{
"value": "100",
"label": "Banco de santiago del estero"
},
{
"value": "101",
"label": "Banco de servicios financieros"
},
{
"value": "102",
"label": "Banco de servicios y transacciones"
},
{
"value": "103",
"label": "Banco de valores"
},
{
"value": "107",
"label": "Banco do brasil"
},
{
"value": "108",
"label": "Banco empresario de tucuman coop. l"
},
{
"value": "109",
"label": "Banco finansur"
},
{
"value": "110",
"label": "Banco hipotecario"
},
{
"value": "145",
"label": "Banco industrial s.a."
},
{
"value": "111",
"label": "Banco itau buen ayre"
},
{
"value": "112",
"label": "Banco julio"
},
{
"value": "113",
"label": "Banco macro"
},
{
"value": "114",
"label": "Banco mariva"
},
{
"value": "115",
"label": "Banco mas ventas"
},
{
"value": "116",
"label": "Banco mercurio"
},
{
"value": "117",
"label": "Banco meridian"
},
{
"value": "118",
"label": "Banco municipal de rosario"
},
{
"value": "119",
"label": "Banco patagonia sudameris"
},
{
"value": "120",
"label": "Banco piano"
},
{
"value": "121",
"label": "Banco privado de inversiones"
},
{
"value": "123",
"label": "Banco provincia del neuquen"
},
{
"value": "122",
"label": "Banco provincia de tierra del fuego"
},
{
"value": "124",
"label": "Banco regional de cuyo"
},
{
"value": "126",
"label": "Banco roela"
},
{
"value": "127",
"label": "Banco saenz"
},
{
"value": "128",
"label": "Banco supervielle s.a."
},
{
"value": "129",
"label": "Bank of america, national associa"
},
{
"value": "131",
"label": "Bbva banco frances"
},
{
"value": "1057",
"label": "Belo"
},
{
"value": "132",
"label": "Bnp paribas"
},
{
"value": "372",
"label": "Brubank"
},
{
"value": "133",
"label": "Citibank"
},
{
"value": "134",
"label": "Deutsche bank"
},
{
"value": "135",
"label": "Hsbc bank argentina"
},
{
"value": "130",
"label": "Industrial and commercial bank of china (icbc)"
},
{
"value": "136",
"label": "Ing bank"
},
{
"value": "137",
"label": "J p morgan chase bank sucursal buenos aires"
},
{
"value": "957",
"label": "Lemon"
},
{
"value": "138",
"label": "Lloyds tsb bank"
},
{
"value": "139",
"label": "M. b. a. banco de inversiones"
},
{
"value": "1055",
"label": "Naranja x"
},
{
"value": "140",
"label": "Nuevo banco bisel"
},
{
"value": "141",
"label": "Nuevo banco de entre rios"
},
{
"value": "142",
"label": "Nuevo banco de la rioja"
},
{
"value": "144",
"label": "Nuevo banco del chaco"
},
{
"value": "143",
"label": "Nuevo banco de santa fe"
},
{
"value": "146",
"label": "Nuevo banco suquia"
},
{
"value": "1056",
"label": "Prex"
},
{
"value": "147",
"label": "Rci banque argentina"
},
{
"value": "847",
"label": "Standard bank argentina"
},
{
"value": "148",
"label": "The bank of tokyo - mitsubishi"
},
{
"value": "729",
"label": "Uala"
},
{
"value": "374",
"label": "Wilobank"
}
]
},
{
"type": "select",
"name": "Tipo",
"key": "account_type_bank",
"options": [
{
"value": "C",
"label": "Cuenta corriente"
},
{
"value": "S",
"label": "Cuenta de ahorros"
}
]
},
{
"type": "text",
"name": "CBU / CVU",
"key": "account_bank",
"min": 18,
"max": 22
},
{
"type": "select",
"name": "Tipo de cliente",
"key": "fc_customer_type",
"options": [
{
"value": "business",
"label": "Empresa"
},
{
"value": "natural",
"label": "Natural"
}
]
},
{
"type": "text",
"name": "Nombre completo",
"key": "fc_legal_name",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "select",
"name": "Tipo de documento",
"key": "fc_document_type",
"options": [
{
"value": "company_id",
"label": "Documento de identificación de empresas"
},
{
"value": "dni",
"label": "Documento nacional de identidad"
},
{
"value": "passport",
"label": "Pasaporte"
}
],
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Número de documento",
"key": "fc_document_number",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Domicilio completo",
"key": "fc_legal_address",
"min": 1,
"max": 200,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Razón social",
"key": "fc_legal_name",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Nombre fantasía",
"key": "fc_trade_name",
"min": 0,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Número de TAX ID",
"key": "fc_tax_id",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Domicilio legal",
"key": "fc_legal_address",
"min": 1,
"max": 200,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Fecha de nacimiento (yyyy-mm-dd)",
"key": "fc_birthdate",
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "select",
"name": "Propósito",
"key": "purpose",
"options": [
{
"value": "ISSAVG",
"label": "Ahorro / jubilación"
},
{
"value": "ISGDDS",
"label": "Compra venta de bienes"
},
{
"value": "ISSCVE",
"label": "Compra venta de servicios"
},
{
"value": "EPDISP",
"label": "Disponibilidades"
},
{
"value": "ISSTDY",
"label": "Educación"
},
{
"value": "EPPROP",
"label": "Inmuebles"
},
{
"value": "EPFAMT",
"label": "Mantenimiento familiar"
},
{
"value": "EPREMT",
"label": "Otros"
},
{
"value": "ISTAXS",
"label": "Pago de impuestos"
},
{
"value": "EPIVST",
"label": "Pago de inversión"
},
{
"value": "ISPAYR",
"label": "Pago de nómina"
},
{
"value": "ISSUPP",
"label": "Pago de proveedor"
},
{
"value": "ISMDCS",
"label": "Salud"
},
{
"value": "EPTOUR",
"label": "Turismo"
}
]
},
{
"type": "text",
"name": "Comentario",
"key": "purpose_comentary",
"min": 5,
"max": 50
}
]
}
}Chile
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"payment_data": [
{
"key": "beneficiary_id",
"name": "RUT (Beneficiary ID)",
"type": "text",
"required": true
},
{
"key": "beneficiary_name",
"name": "Beneficiary Name",
"type": "text",
"required": true
},
{
"key": "beneficiary_account",
"name": "Beneficiary Account (CCI)",
"type": "text",
"required": true
},
{
"key": "beneficiary_account_type",
"name": "Beneficiary Account Type",
"type": "text",
"required": true
},
{
"key": "beneficiary_bank_code",
"name": "Beneficiary Bank Code",
"type": "text",
"required": true
},
{
"key": "beneficiary_email",
"name": "Beneficiary Email",
"type": "text",
"required": false
},
{
"key": "description",
"name": "Transfer Description",
"type": "text",
"required": true
}
]
}
}Colombia
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"payment_data": [
{
"key": "bankAccount",
"name": "Account Number",
"type": "number",
"value": null,
"required": true
},
{
"key": "AccountType",
"name": "Account Type",
"type": "select",
"value": null,
"options": [
{
"label": "US",
"value": "us"
},
{
"label": "IBAN",
"value": "iban"
}
],
"required": true
},
{
"key": "bankCode",
"name": "Select Bank",
"type": "select",
"value": null,
"options": [
{
"id": 366,
"code": "059",
"name": "Bancamia S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 367,
"code": "040",
"name": "Banco Agrario",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 12
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 12
}
],
"isActive": true
},
{
"id": 368,
"code": "052",
"name": "Banco Av. Villas",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 11
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 13
}
],
"isActive": true
},
{
"id": 369,
"code": "032",
"name": "Banco Caja Social BCSC",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 12
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 12
}
],
"isActive": true
},
{
"id": 370,
"code": "019",
"name": "Scotiabank Colpatria",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 10
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 10
}
],
"isActive": true
},
{
"id": 371,
"code": "067",
"name": "Banco Compartir S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 372,
"code": "051",
"name": "Banco Davivienda",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 373,
"code": "001",
"name": "Banco de Bogota",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 11
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 11
}
],
"isActive": true
},
{
"id": 374,
"code": "023",
"name": "Banco de Occidente",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 9
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 9
}
],
"isActive": true
},
{
"id": 375,
"code": "062",
"name": "Banco Falabella S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 12
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 12
}
],
"isActive": true
},
{
"id": 376,
"code": "063",
"name": "Banco Finandina S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 377,
"code": "064",
"name": "Banco Multibank S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 378,
"code": "047",
"name": "Banco Mundo Mujer",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 379,
"code": "060",
"name": "Banco Pichincha",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 381,
"code": "058",
"name": "Banco Procredit",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 13
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 13
}
],
"isActive": true
},
{
"id": 382,
"code": "006",
"name": "Banco Santander",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 9
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 9
}
],
"isActive": true
},
{
"id": 383,
"code": "069",
"name": "Banco Serfinanza S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 384,
"code": "012",
"name": "Banco Sudameris",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 8
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 11
}
],
"isActive": true
},
{
"id": 385,
"code": "053",
"name": "Banco W S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 386,
"code": "031",
"name": "Bancoldex S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 387,
"code": "007",
"name": "Bancolombia",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 11
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 11
}
],
"isActive": true
},
{
"id": 388,
"code": "061",
"name": "Bancoomeva",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 12
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 12
}
],
"isActive": true
},
{
"id": 389,
"code": "013",
"name": "BBVA",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 16
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 16
}
],
"isActive": true
},
{
"id": 390,
"code": "370",
"name": "Coltefinanciera S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 391,
"code": "292",
"name": "Confiar",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 9
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 9
}
],
"isActive": true
},
{
"id": 392,
"code": "076",
"name": "Coopcentral S.A.",
"countryCode": "COL",
"accountTypes": [
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 9
}
],
"isActive": true
},
{
"id": 394,
"code": "289",
"name": "Cotrafa Cooperativa Financiera",
"countryCode": "COL",
"accountTypes": [
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 13
}
],
"isActive": true
},
{
"id": 395,
"code": "551",
"name": "Daviplata",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 396,
"code": "296",
"name": "Financiera Juriscoop",
"countryCode": "COL",
"accountTypes": [
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 12
}
],
"isActive": true
},
{
"id": 397,
"code": "010",
"name": "HSBC",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 15
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 15
}
],
"isActive": true
},
{
"id": 398,
"code": "014",
"name": "Itau",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 9
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 9
}
],
"isActive": true
},
{
"id": 399,
"code": "507",
"name": "Nequi",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 400,
"code": "637",
"name": "Iris",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
},
{
"id": 401,
"code": "097",
"name": "Banco Dale",
"countryCode": "COL",
"accountTypes": [
{
"code": "2",
"name": "Savings",
"minAddressLength": 3,
"maxAddressLength": 18
},
{
"code": "1",
"name": "Checking",
"minAddressLength": 3,
"maxAddressLength": 18
}
],
"isActive": true
}
],
"required": true
}
]
}
}Mexico
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"payment_data": [
{
"key": "clabe",
"name": "Clabe Number",
"type": "number",
"value": null,
"required": true
},
{
"key": "beneficiary",
"name": "Beneficiary Full Name",
"type": "text",
"value": null,
"required": true
}
]
}
}Peru
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"payment_data": [
{
"type": "text",
"name": "Nombres",
"key": "beneficiary_first_name",
"min": 3,
"max": 50
},
{
"type": "text",
"name": "Apellidos",
"key": "beneficiary_last_name",
"min": 3,
"max": 50
},
{
"type": "email",
"name": "Correo",
"key": "beneficiary_email",
"max": 80
},
{
"type": "text",
"name": "Dirección",
"key": "beneficiary_address",
"min": 3,
"max": 200
},
{
"type": "text",
"name": "Ciudad",
"key": "city",
"min": 3,
"max": 50
},
{
"type": "text",
"name": "Teléfono",
"key": "phone",
"min": 6,
"max": 9
},
{
"type": "select",
"name": "Tipo de documento",
"key": "beneficiary_document_type",
"options": [
{
"value": "CE",
"label": "Carnet de extranjería"
},
{
"value": "DNI",
"label": "Documento nacional de identidad"
},
{
"value": "PASS",
"label": "Pasaporte"
},
{
"value": "RUC",
"label": "Registro único de contribuyentes"
}
]
},
{
"type": "text",
"name": "Nro de documento",
"key": "beneficiary_document_number",
"min": 6
},
{
"type": "select",
"name": "Banco",
"key": "bank_code",
"options": [
{
"value": "265",
"label": "Banco de crédito del perú"
},
{
"value": "266",
"label": "Interbank"
},
{
"value": "269",
"label": "Bbva continental"
},
{
"value": "1024",
"label": "Alfin banco"
},
{
"value": "264",
"label": "Banco central de reserva"
},
{
"value": "271",
"label": "Banco de comercio"
},
{
"value": "270",
"label": "Banco de la nación"
},
{
"value": "277",
"label": "Banco falabella"
},
{
"value": "272",
"label": "Banco financiero"
},
{
"value": "276",
"label": "Banco gnb perú s.a."
},
{
"value": "273",
"label": "Banco interamericano de finanzas (bif)"
},
{
"value": "1054",
"label": "Banco pichincha"
},
{
"value": "279",
"label": "Caja metropolitana de lima"
},
{
"value": "282",
"label": "Caja municipal de ahorro y crédito arequipa"
},
{
"value": "284",
"label": "Caja municipal de ahorro y crédito cuzco"
},
{
"value": "285",
"label": "Caja municipal de ahorro y crédito huancayo"
},
{
"value": "280",
"label": "Caja municipal de ahorro y crédito piura sac"
},
{
"value": "283",
"label": "Caja municipal de ahorro y crédito sullana"
},
{
"value": "286",
"label": "Caja municipal de ahorro y crédito tacna"
},
{
"value": "281",
"label": "Caja municipal de ahorro y crédito trujillo"
},
{
"value": "267",
"label": "Citibank"
},
{
"value": "274",
"label": "Crediscotia financiera"
},
{
"value": "275",
"label": "Mi banco"
},
{
"value": "278",
"label": "Santander"
},
{
"value": "268",
"label": "Scotiabank"
}
]
},
{
"type": "select",
"name": "Tipo",
"key": "account_type_bank",
"options": [
{
"value": "C",
"label": "Cuenta corriente"
},
{
"value": "S",
"label": "Cuenta de ahorros"
},
{
"value": "M",
"label": "Cuenta maestra"
}
]
},
{
"type": "text",
"name": "Código interbancario",
"key": "account_bank",
"min": 20,
"max": 20
},
{
"type": "select",
"name": "Tipo de cliente",
"key": "fc_customer_type",
"options": [
{
"value": "business",
"label": "Empresa"
},
{
"value": "natural",
"label": "Natural"
}
]
},
{
"type": "text",
"name": "Nombre completo",
"key": "fc_legal_name",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "select",
"name": "Tipo de documento",
"key": "fc_document_type",
"options": [
{
"value": "company_id",
"label": "Documento de identificación de empresas"
},
{
"value": "dni",
"label": "Documento nacional de identidad"
},
{
"value": "passport",
"label": "Pasaporte"
}
],
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Número de documento",
"key": "fc_document_number",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Domicilio completo",
"key": "fc_legal_address",
"min": 1,
"max": 200,
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "text",
"name": "Razón social",
"key": "fc_legal_name",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Nombre fantasía",
"key": "fc_trade_name",
"min": 0,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Número de TAX ID",
"key": "fc_tax_id",
"min": 1,
"max": 50,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Domicilio legal",
"key": "fc_legal_address",
"min": 1,
"max": 200,
"when": {
"key": "fc_customer_type",
"value": "business"
}
},
{
"type": "text",
"name": "Fecha de nacimiento (yyyy-mm-dd)",
"key": "fc_birthdate",
"when": {
"key": "fc_customer_type",
"value": "natural"
}
},
{
"type": "select",
"name": "Propósito",
"key": "purpose",
"options": [
{
"value": "ISSAVG",
"label": "Ahorro / jubilación"
},
{
"value": "ISGDDS",
"label": "Compra venta de bienes"
},
{
"value": "ISSCVE",
"label": "Compra venta de servicios"
},
{
"value": "EPDISP",
"label": "Disponibilidades"
},
{
"value": "ISSTDY",
"label": "Educación"
},
{
"value": "EPPROP",
"label": "Inmuebles"
},
{
"value": "EPFAMT",
"label": "Mantenimiento familiar"
},
{
"value": "EPREMT",
"label": "Otros"
},
{
"value": "ISTAXS",
"label": "Pago de impuestos"
},
{
"value": "EPIVST",
"label": "Pago de inversión"
},
{
"value": "ISPAYR",
"label": "Pago de nómina"
},
{
"value": "ISSUPP",
"label": "Pago de proveedor"
},
{
"value": "ISMDCS",
"label": "Salud"
},
{
"value": "EPTOUR",
"label": "Turismo"
}
]
},
{
"type": "text",
"name": "Comentario",
"key": "purpose_comentary",
"min": 5,
"max": 50
}
]
}
}3
Step 3: Add Beneficiary Payment Details
Submit a POST request to add beneficiary payment details using the obtained form structure:
POST {{host}}/beneficiaries/payment-methods/
Payload examples:
Argentina
{
"gateway_id": 492,
"nickname": "Arg acct",
"currency": "ARS",
"payment_data": {
"beneficiary_type": "Individual",
"beneficiary_first_name": "John",
"beneficiary_last_name": "Doe",
"company_name": null,
"beneficiary_email": "[email protected]",
"beneficiary_address": "Address not provided",
"beneficiary_document_type": "CUIL",
"beneficiary_document_number": "20123456789",
"bank_code": "92",
"account_type_bank": "C",
"account_bank": "0290015510000123456789",
"fc_customer_type": "natural",
"fc_legal_name": "John Doe",
"fc_document_type": "dni",
"fc_document_number": "12345678",
"fc_legal_address": "Address not provided",
"fc_birthdate": "1990-01-01",
"purpose": "EPFAMT",
"purpose_comentary": "Mantenimiento familiar"
}
}Chile
{
"gateway_id": 505,
"nickname": "CHL acct",
"currency": "CLP",
"payment_data": {
"beneficiary_id" : "xxxxxxxxxx",
"beneficiary_name" : "Someone",
"beneficiary_account" : "xxxxxxx",
"beneficiary_account_type": "2",
"beneficiary_bank_code": "xxx",
"beneficiary_email": "[email protected]",
"description": "transfer"
}
//"customer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}Colombia
{
"gateway_id": 2,
"nickname": "COL acct",
"currency": "COL",
"payment_data": {
"bankAccount" : "xxx-xxxxxxxx-xx",
"AccountType" : "2",
"bankCode" : "007"
}
//"customer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}Mexico
{
"gateway_id": 1,
"nickname": "MXN acct",
"currency": "MXN",
"payment_data": {
"clabe" : "xxxxxxxxxxxxxxxxxxx",
"beneficiary": "Someone"
}
//"customer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
}Peru
{
"gateway_id": 501,
"nickname": "Peru acct",
"currency": "PEN",
"payment_data": {
"beneficiary_first_name" : "Jane",
"beneficiary_last_name" : "Smith",
"beneficiary_email" : "[email protected]",
"beneficiary_address": "123 Placeholder Ave, Lima",
"city": "Lima",
"phone": "099999",
"beneficiary_document_type": "DNI",
"beneficiary_document_number": 12345678,
"bank_code": 265,
"account_type_bank": "c",
"account_bank": "00219311305161234567",
"fc_customer_type": "natural",
"fc_legal_name" : "Jane Smith",
"fc_document_type": "DNI",
"fc_document_number": 12345678,
"fc_legal_address": "123 Placeholder Ave, Lima",
"fc_birthdate": "1990-02-02",
"purpose": "ISSCVE",
"purpose_comentary": "Payment"
}
//"customer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}Response examples (success):
Argentina
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Payment data processed successfully",
"data": {
"user_id": 1001,
"currency": "ARS",
"gateway_id": 492,
"nickname": "Arg acct",
"address": null,
"payment_data": {
"beneficiary_type": "Individual",
"beneficiary_first_name": "John",
"beneficiary_last_name": "Doe",
"company_name": null,
"beneficiary_email": "[email protected]",
"beneficiary_address": "123 Placeholder St",
"beneficiary_document_type": "CUIL",
"beneficiary_document_number": "20123456789",
"bank_code": "92",
"account_type_bank": "C",
"account_bank": "xxxxxxxxxxxxxxxxxxxxxx",
"fc_customer_type": "natural",
"fc_legal_name": "John Doe",
"fc_document_type": "dni",
"fc_document_number": "12345678",
"fc_legal_address": "123 Placeholder St",
"fc_birthdate": "1990-01-01",
"purpose": "EPFAMT",
"purpose_comentary": "Mantenimiento familiar"
},
"beneficiary_id": null,
"created_at": "2025-02-17T11:38:04.000000Z",
"id": 999
}
}
}Chile
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Payment data processed successfully",
"data": {
"user_id": 1002,
"currency": "CLP",
"gateway_id": 505,
"nickname": "CHL acct",
"address": null,
"payment_data": {
"beneficiary_id": "123456789",
"beneficiary_name": "Placeholder Company SpA",
"beneficiary_account": "12345678",
"beneficiary_account_type": "2",
"beneficiary_bank_code": "016",
"beneficiary_email": "[email protected]",
"description": "transfer"
},
"beneficiary_id": null,
"created_at": "2025-02-17T13:35:19.000000Z",
"id": 998
}
}
}Colombia
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Payment data processed successfully",
"data": {
"user_id": 4,
"currency": "COP",
"gateway_id": 2,
"nickname": "COL acct",
"address": null,
"payment_data": {
"bankAccount": "xxx-xx-51",
"AccountType": "2",
"bankCode": "007"
},
"beneficiary_id": null,
"created_at": "2025-02-17T13:22:48.000000Z",
"id": 11
}
}
}Mexico
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Payment data processed successfully",
"data": {
"user_id": 4,
"currency": "MXN",
"gateway_id": 1,
"nickname": "MXN acct",
"address": null,
"payment_data": {
"clabe": "638180010192109625",
"beneficiary": "Carolina Rosero"
},
"beneficiary_id": null,
"created_at": "2025-02-17T12:41:32.000000Z",
"id": 9
}
}
}Peru
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"message": "Payment data processed successfully",
"data": {
"user_id": 4,
"currency": "PEN",
"gateway_id": 501,
"nickname": "Peru acct",
"address": null,
"payment_data": {
"beneficiary_first_name": "Laureano Serafin",
"beneficiary_last_name": "Rodriguez Polo",
"beneficiary_email": "[email protected]",
"beneficiary_address": "1 saint street, Lima",
"city": "Lima",
"phone": "099922",
"beneficiary_document_type": "DNI",
"beneficiary_document_number": 40224529,
"bank_code": 265,
"account_type_bank": "c",
"account_bank": "00219311305166509915",
"fc_customer_type": "natural",
"fc_legal_name": "Laureano Serafin Rodriguez Polo",
"fc_document_type": "DNI",
"fc_document_number": 40224529,
"fc_legal_address": "1 saint street, Lima",
"fc_birthdate": "1990-02-02",
"purpose": "ISSCVE",
"purpose_comentary": "Payment"
},
"beneficiary_id": null,
"created_at": "2025-02-17T13:06:48.000000Z",
"id": 10
}
}
}4
Step 4: Retrieve Beneficiary Payment Details (Optional)
To retrieve all added beneficiary payment details:
GET {{host}}/beneficiaries/payment-methods/all
Response example:
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": [
{
"id": 12,
"gateway_id": 505,
"beneficiary_id": null,
"nickname": "CHL acct",
"currency": "CLP",
"address": null,
"payment_data": {
"beneficiary_id": "999999999",
"beneficiary_name": "Dummy Company SPA",
"beneficiary_account": "12345678",
"beneficiary_account_type": "2",
"beneficiary_bank_code": "999",
"beneficiary_email": "[email protected]",
"description": "transfer"
},
"created_at": "2025-02-17T13:35:19.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 505,
"method_name": "Bank Transfer",
"country": "CHL",
"currency": "CLP",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "CLP",
"exchange_rate_float": null
}
},
{
"id": 11,
"gateway_id": 2,
"beneficiary_id": null,
"nickname": "COL acct",
"currency": "COP",
"address": null,
"payment_data": {
"bankAccount": "000-000000-00",
"AccountType": "2",
"bankCode": "000"
},
"created_at": "2025-02-17T13:22:48.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 2,
"method_name": "Bank Transfer",
"country": "COL",
"currency": "COP",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
},
{
"id": 10,
"gateway_id": 501,
"beneficiary_id": null,
"nickname": "Peru acct",
"currency": "PEN",
"address": null,
"payment_data": {
"beneficiary_first_name": "John",
"beneficiary_last_name": "Doe",
"beneficiary_email": "[email protected]",
"beneficiary_address": "123 Fake Street, Lima",
"city": "Lima",
"phone": "0000000000",
"beneficiary_document_type": "DNI",
"beneficiary_document_number": 12345678,
"bank_code": 000,
"account_type_bank": "c",
"account_bank": "00000000000000000000",
"fc_customer_type": "natural",
"fc_legal_name": "John Doe",
"fc_document_type": "DNI",
"fc_document_number": 12345678,
"fc_legal_address": "123 Fake Street, Lima",
"fc_birthdate": "1990-01-01",
"purpose": "TESTING",
"purpose_comentary": "Test payment"
},
"created_at": "2025-02-17T13:06:48.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 501,
"method_name": "Bank Transfer",
"country": "PER",
"currency": "PEN",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
},
{
"id": 9,
"gateway_id": 1,
"beneficiary_id": null,
"nickname": "MXN acct",
"currency": "MXN",
"address": null,
"payment_data": {
"clabe": "000000000000000000",
"beneficiary": "Jane Doe"
},
"created_at": "2025-02-17T12:41:32.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 1,
"method_name": "SPEI",
"country": "MEX",
"currency": "MXN",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
},
{
"id": 8,
"gateway_id": 494,
"beneficiary_id": null,
"nickname": "BRA acct",
"currency": "BRL",
"address": null,
"payment_data": {
"taxId": "00000000000",
"pixKey": "[email protected]"
},
"created_at": "2025-02-17T12:15:52.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 494,
"method_name": "Pix",
"country": "BRA",
"currency": "BRL",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD,BRL",
"exchange_rate_float": null
}
},
{
"id": 7,
"gateway_id": 492,
"beneficiary_id": null,
"nickname": "Arg acct",
"currency": "ARS",
"address": null,
"payment_data": {
"beneficiary_type": "Individual",
"beneficiary_first_name": "Alice",
"beneficiary_last_name": "Brown",
"company_name": null,
"beneficiary_email": "[email protected]",
"beneficiary_address": "456 Nowhere Rd",
"beneficiary_document_type": "CUIL",
"beneficiary_document_number": "00000000000",
"bank_code": "00",
"account_type_bank": "C",
"account_bank": "0000000000000000000000",
"fc_customer_type": "natural",
"fc_legal_name": "Alice Brown",
"fc_document_type": "dni",
"fc_document_number": "00000000",
"fc_legal_address": "456 Nowhere Rd",
"fc_birthdate": "1990-01-01",
"purpose": "TEST",
"purpose_comentary": "Test transaction"
},
"created_at": "2025-02-17T11:38:04.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 492,
"method_name": "Bank Transfer",
"country": "ARG",
"currency": "ARS",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
},
{
"id": 5,
"gateway_id": 492,
"beneficiary_id": null,
"nickname": "Arg acct",
"currency": "ARS",
"address": null,
"payment_data": {
"beneficiary_type": "Individual",
"beneficiary_first_name": "Alice",
"beneficiary_last_name": "Brown",
"company_name": null,
"beneficiary_email": "[email protected]",
"beneficiary_address": "456 Nowhere Rd",
"beneficiary_document_type": "CUIL",
"beneficiary_document_number": "00000000000",
"bank_code": "00",
"account_type_bank": "C",
"account_bank": "0000000000000000000000",
"fc_customer_type": "natural",
"fc_legal_name": "Alice Brown",
"fc_document_type": "dni",
"fc_document_number": "00000000",
"fc_legal_address": "456 Nowhere Rd",
"fc_birthdate": "1990-01-01",
"purpose": "TEST",
"purpose_comentary": "Test transaction"
},
"created_at": "2025-02-16T21:31:52.000000Z",
"user_id": 4,
"bridge_id": null,
"bridge_customer_id": null,
"bridge_response": null,
"gateway": {
"id": 492,
"method_name": "Bank Transfer",
"country": "ARG",
"currency": "ARS",
"payment_method_code": null,
"cutoff_hrs_start": null,
"cutoff_hrs_end": null,
"base_currency": "USD",
"exchange_rate_float": null
}
},
{
"id": 4,
"gateway_id": 333,
"beneficiary_id": null,
"nickname": "Bridge payment sample EUR",
"currency": "IDR",
"address": null,
"payment_data": {
"account_number": "XX0000000000000000000000",
"account_name": "Test User",
"routing_number": "SWIFT00000",
"account_type": "iban",
"address": {
"line1": "123 Test Blvd",
"line2": null,
"city": "Testville",
"state": "Teststate",
"postal_code": "00000",
"country": "XX"
},
"iban_account_number": "XX0000000000000000000000",
"iban_bic": "TESTBICX",
"iban_country": "XX",
"account_owner_type": "individual",
"first_name": "Test",
"last_name": "User"
},
"created_at": "2025-02-15T12:36:53.000000Z",
"user_id": 4,
"bridge_id": null
}
]
}5
Step 5: Initiate Payout
Use the id from the previous response as the payment_method_id to make a payout request:
POST {{host}}/wallet/payout
Payload examples:
Argentina
{
"debit_wallet": "USD",
"amount": 17,
"payment_method_id": 5
}Chile
{
"debit_wallet": "CLP",
"amount": 1000,
"payment_method_id": 12
}Colombia
{
"debit_wallet": "USD",
"amount": 10000,
"payment_method_id": 11
}Mexico
{
"debit_wallet": "USD",
"amount": 1,
"payment_method_id": 9
}Peru
{
"debit_wallet": "USD",
"amount": 75,
"payment_method_id": 10
}USA
{
"debit_wallet": "USD",
"amount": 11,
"payment_method_id": 14
}Stablecoin
{
"debit_wallet": "CLP",
"amount": 75,
"payment_method_id": 505
}Response examples:
Argentina
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request received and will be processed shortly.",
"data": {
"amount": 17,
"debit_wallet": "USD",
"user_id": 4,
"raw_data": {
"debit_wallet": "USD",
"amount": 17,
"payment_method_id": 5
},
"currency": "ARS",
"beneficiary_id": 5,
"payout_id": "bf3b5096-f24d-419c-967f-dd8c75512ec4",
"updated_at": "2025-02-17T11:34:38.000000Z",
"created_at": "2025-02-17T11:34:38.000000Z"
}
}Chile
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request received and will be processed shortly.",
"data": {
"amount": 10000,
"debit_wallet": "CLP",
"user_id": 4,
"raw_data": {
"debit_wallet": "CLP,
"amount": 1000,
"payment_method_id": 12
},
"currency": "CLP",
"beneficiary_id": 12,
"payout_id": "4a269cd6-f7a3-47e3-9946-d954a21c57da",
"updated_at": "2025-02-17T13:23:57.000000Z",
"created_at": "2025-02-17T13:23:57.000000Z"
}
}Colombia
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request received and will be processed shortly.",
"data": {
"amount": 10000,
"debit_wallet": "USD",
"user_id": 4,
"raw_data": {
"debit_wallet": "USD",
"amount": 10000,
"payment_method_id": 11
},
"currency": "COP",
"beneficiary_id": 11,
"payout_id": "4a269cd6-f7a3-47e3-9946-d954a21c57da",
"updated_at": "2025-02-17T13:23:57.000000Z",
"created_at": "2025-02-17T13:23:57.000000Z"
}
}Mexico
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request received and will be processed shortly.",
"data": {
"amount": 1,
"debit_wallet": "USD",
"user_id": 4,
"raw_data": {
"debit_wallet": "USD",
"amount": 1,
"payment_method_id": 9
},
"currency": "MXN",
"beneficiary_id": 9,
"payout_id": "767b0063-2427-421e-a56c-b3253a1d0bde",
"updated_at": "2025-02-17T12:42:17.000000Z",
"created_at": "2025-02-17T12:42:17.000000Z"
}
}Peru
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request received and will be processed shortly.",
"data": {
"amount": 75,
"debit_wallet": "USD",
"user_id": 4,
"raw_data": {
"debit_wallet": "USD",
"amount": 75,
"payment_method_id": 10
},
"currency": "PEN",
"beneficiary_id": 10,
"payout_id": "ca59fba7-dad6-4d2a-bb04-deb4500b68d3",
"updated_at": "2025-02-17T13:07:55.000000Z",
"created_at": "2025-02-17T13:07:55.000000Z"
}
}USA
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request initiated successfully",
"data": {
"withdrawal_id": 94,
"payout_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx",
"status": "pending",
"debit_amount": 12,
"target_amount": {
"wallet_currency": 12,
"payout_currency": 12
},
"currency": "USD",
"fees": {
"total_amount": {
"wallet_currency": 12,
"payout_currency": 12
},
"amount_due": 12,
"exchange_rate": 1,
"target_currency": "usd",
"customer_receive_amount": {
"wallet_currency": 11,
"payout_currency": 11
}
},
"processed_at": "2025-04-14T14:10:22.000000Z"
}
}Stablecoin
{
"status": "success",
"status_code": 201,
"message": "Withdrawal request initiated successfully",
"data": {
"withdrawal_id": 93,
"payout_id": "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx",
"status": "pending",
"debit_amount": 10.4,
"target_amount": {
"wallet_currency": 10.4,
"payout_currency": 10.4
},
"currency": "USD",
"fees": {
"total_amount": {
"wallet_currency": 10.4,
"payout_currency": 10.4
},
"amount_due": 10.4,
"exchange_rate": 1,
"target_currency": "USD",
"customer_receive_amount": {
"wallet_currency": 10,
"payout_currency": 10
}
},
"processed_at": "2025-04-14T13:57:43.000000Z"
}
}Payout (Omnibus Gateways Only)
To use this payout method the Customer must be enrolled to this service and completed compliance.
Make a POST request to: POST {{base_url}}/api/v1/epay/withdraw
Parameters:
customer_id (Yes) — The customer’s yativo ID
coin (Yes) — the payout currency
cbu (Yes) — the cbu
amount (Yes) — amount to be paid
Note: The USD equivalent value is debited from your Yativo USD balance
Example:
{
"customer_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"coin": "ARS",
"cbu": "34xxxxxxxxxx",
"amount": "10"
}Retrieve Payment details
To get a list of all payment details:
GET {{base_url}}/api/v1/beneficiaries/payment-methods/all
Update payment details
To update a beneficiary payment detail:
PUT {{base_url}}/api/v1/beneficiaries/payment-methods/update/{{payment_detail_id}}
Include the updated payment detail as the payload.
DELETE Payment details
To delete a payment detail entry:
DELETE {{base_url}}/api/v1/beneficiaries/payment-methods/delete/{{payment_detail_id}}
Authentication & Idempotency
Authentication: All requests must be authenticated.
Idempotency: POST requests require a unique Idempotency-Key header for each unique request to avoid duplicate processing.
For further support, please contact Us.