Skip to main content
POST
/
payout-requests
Crear solicitud de desembolso
curl --request POST \
  --url https://api.pay.palomma.com/payout-requests \
  --header 'Content-Type: application/json' \
  --data '{
  "payee_bank": "santander",
  "payee_bank_account_type": "CHECKING",
  "payee_bank_account_number": "<string>",
  "payee_name": "<string>",
  "payee_document_type": "CC",
  "payee_document_number": "<string>",
  "amount_cents": 123
}'
{
  "id": "<string>",
  "status": "<string>",
  "amount_cents": 123,
  "payee_bank": "santander",
  "payee_bank_account_type": "CHECKING",
  "payee_bank_account_number": "<string>",
  "payee_name": "<string>",
  "payee_document_type": "CC",
  "payee_document_number": "<string>",
  "created_at": 123,
  "last_modified": 123
}
URLs base Producción: https://api.pay.palomma.com Sandbox: https://api.sandbox-pay.palomma.com

Body

application/json
​
payee_bank
enum<string>
required

El código de la institución bancaria del beneficiario. Opciones: santander - Banco Santander Colombia, coofinep - COOFINEP, avvillas - Banco AV Villas, cotrafa - Cotrafa, confiar - Confiar, union - Banco Union (antes Giros), nequi - Nequi, bancoagrario - Banco Agrario, bancoomeva - Bancoomeva, bancamia - Bancamía, coopcentral - Banco Cooperativo Coopcentral, citibank - Citibank, bancodeoccidente - Banco de Occidente, falabella - Banco Falabella, bancodebogota - Banco de Bogotá, bancocajasocial - Banco Caja Social, serfinanza - Banco Serfinanza, cfa - Cooperativa Financiera de Antioquia, coltefinanciera - Coltefinanciera, pichincha - Banco Pichincha, iris - IRIS, ban100 - Ban100 (antes Credifinanciera), bancopopular - Banco Popular, daviplata - DaviPlata, bancolombia - Bancolombia, finandina - Banco Finandina, scotiabankcolpatria - Scotiabank Colpatria, gnbsudameris - GNB Sudameris, itau - Banco Itaú, bbva - BBVA Colombia, davivienda - Davivienda, mibanco - Mibanco, multibank - Multibank, mundomujer - Mundo Mujer, procreditcolombia - Procredit Colombia, bancow - Banco W, bancoldex - Bancóldex, juriscoop - Financiera Juriscoop, itauhelm - Itaú (Helm Bank), jpmorgancolombia - JP Morgan Colombia

Available options:
santander,
coofinep,
avvillas,
cotrafa,
confiar,
union,
nequi,
bancoagrario,
bancoomeva,
bancamia,
coopcentral,
citibank,
bancodeoccidente,
falabella,
bancodebogota,
bancocajasocial,
serfinanza,
cfa,
coltefinanciera,
pichincha,
iris,
ban100,
bancopopular,
daviplata,
bancolombia,
finandina,
scotiabankcolpatria,
gnbsudameris,
itau,
bbva,
davivienda,
mibanco,
multibank,
mundomujer,
procreditcolombia,
bancow,
bancoldex,
juriscoop,
itauhelm,
jpmorgancolombia
​
payee_bank_account_type
enum<string>
required

El tipo de cuenta del beneficiario. Puede ser CHECKING - Corriente, SAVINGS - Ahorros.

Available options:
CHECKING,
SAVINGS
​
payee_bank_account_number
string
required

El número de cuenta del beneficiario.

​
payee_name
string
required

El nombre del beneficiario (titular de la cuenta).

​
payee_document_type
enum<string>
required

El tipo de documento de identidad del beneficiario. Opciones: CC - Cédula, CE - Cédula de extranjería, NIT, TI - Tarjeta de Identidad, PP - Pasaporte

Available options:
CC,
CE,
NIT,
TI,
PP
​
payee_document_number
string
required

El número de documento de identidad del beneficiario.

​
amount_cents
integer
required

El monto en centavos para desembolsar.

Response

​
id
string
required

Un identificador único para la solicitud de desembolso.

​
status
string
required

El estado de la solicitud de desembolso. Puede ser MERCHANT_DEBIT_PENDING, MERCHANT_DEBIT_PROCESSING, PAYOUT_PENDING, PAYOUT_PROCESSING, PAYOUT_SENT, MERCHANT_DEBIT_FAILED, PAYOUT_FAILED.

​
amount_cents
integer
required

El monto en centavos para desembolsar.

​
payee_bank
enum<string>
required

El código de la institución bancaria del beneficiario. Opciones: santander - Banco Santander Colombia, coofinep - COOFINEP, avvillas - Banco AV Villas, cotrafa - Cotrafa, confiar - Confiar, union - Banco Union (antes Giros), nequi - Nequi, bancoagrario - Banco Agrario, bancoomeva - Bancoomeva, bancamia - Bancamía, coopcentral - Banco Cooperativo Coopcentral, citibank - Citibank, bancodeoccidente - Banco de Occidente, falabella - Banco Falabella, bancodebogota - Banco de Bogotá, bancocajasocial - Banco Caja Social, serfinanza - Banco Serfinanza, cfa - Cooperativa Financiera de Antioquia, coltefinanciera - Coltefinanciera, pichincha - Banco Pichincha, iris - IRIS, ban100 - Ban100 (antes Credifinanciera), bancopopular - Banco Popular, daviplata - DaviPlata, bancolombia - Bancolombia, finandina - Banco Finandina, scotiabankcolpatria - Scotiabank Colpatria, gnbsudameris - GNB Sudameris, itau - Banco Itaú, bbva - BBVA Colombia, davivienda - Davivienda, mibanco - Mibanco, multibank - Multibank, mundomujer - Mundo Mujer, procreditcolombia - Procredit Colombia, bancow - Banco W, bancoldex - Bancóldex, juriscoop - Financiera Juriscoop, itauhelm - Itaú (Helm Bank), jpmorgancolombia - JP Morgan Colombia

Available options:
santander,
coofinep,
avvillas,
cotrafa,
confiar,
union,
nequi,
bancoagrario,
bancoomeva,
bancamia,
coopcentral,
citibank,
bancodeoccidente,
falabella,
bancodebogota,
bancocajasocial,
serfinanza,
cfa,
coltefinanciera,
pichincha,
iris,
ban100,
bancopopular,
daviplata,
bancolombia,
finandina,
scotiabankcolpatria,
gnbsudameris,
itau,
bbva,
davivienda,
mibanco,
multibank,
mundomujer,
procreditcolombia,
bancow,
bancoldex,
juriscoop,
itauhelm,
jpmorgancolombia
​
payee_bank_account_type
enum<string>
required

El tipo de cuenta del beneficiario. Puede ser CHECKING - Corriente, SAVINGS - Ahorros.

Available options:
CHECKING,
SAVINGS
​
payee_bank_account_number
string
required

El número de cuenta del beneficiario.

​
payee_name
string
required

El nombre del beneficiario (titular de la cuenta).

​
payee_document_type
enum<string>
required

El tipo de documento de identidad del beneficiario. Opciones: CC - Cédula, CE - Cédula de extranjería, NIT, TI - Tarjeta de Identidad, PP - Pasaporte

Available options:
CC,
CE,
NIT,
TI,
PP
​
payee_document_number
string
required

El número de documento de identidad del beneficiario.

​
created_at
integer
required

La fecha de creación de la solicitud de desembolso.

​
last_modified
integer
required

La fecha de la última modificación de la solicitud de desembolso.