Create withdraw request

Withdraw requests can only be created by merchants using API key and signature authentication.

Upon withdraw request received, checks for pending withdrawals and available balance are performed. Pending withdrawals reserve part of merchant balance until Latam withdraw request passes or fails.

/merchant/v1/withdraw/init

Request parameters

{
    "amount": 1000.00,
    "callbackUrl": "callbackUrl",
    "destinationAccount": {
        "country": "country",
        "currency": "currency",
        "destinationType": {
            "type": "ACCOUNT_TYPE",
            // fields vary depending on country
        }
    },
    "externalId": "externalId"
}

Responses

{
  "payoutId": "18ad0215-778d-352d-8f14-959901273e8d",
  "status": "example"
}

Destination Types by Country

The destinationType object structure varies depending on the destination country. Below are the supported types for each country:

Argentina

Currency Support

ARS (Argentine Peso)
USD (US Dollar)

ALIAS

{
    "destinationType": {
        "type": "ALIAS",
        "alias": "ExampleAlias"  // Required: Alias for the account
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "ARGENTINA",
        "currency": "ARS",
        "destinationType": {
            "type": "ALIAS",
            "alias": "ExampleAlias"  
        }
    },
    "externalId": "externalId"
}

CBU

{
    "destinationType": {
        "type": "CBU",
        "cbu": "0123456789012345678901"  // Required: 22-digit CBU number
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "ARGENTINA",
        "currency": "ARS",
        "destinationType": {
            "type": "CBU",
            "cbu": "0123456789012345678901"  
        }
    },
    "externalId": "externalId"
}

Brazil

Currency Support

BRL (Brazilian Real)

Brazil Account

{
    "destinationType": {
        "type": "ACCOUNT_BRAZIL",
        "ispb": "12345678",              // Required: ISPB code
        "number": "123456789",           // Required: Creditor account number
        "issuer": "0001",                // Required: Agency of account
        "accountType": "CACC",           // Required: Values: CACC, SVGS, TRAN, SLRY
        "documentNumber": "12345678901", // Required: Owner account document
        "name": "John Doe"               // Optional: Defaults to "NN" if not provided
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "BRAZIL",
        "currency": "BRL",
        "destinationType": {
            "type": "ACCOUNT_BRAZIL",
            "ispb": "12345678",          
            "number": "123456789",       
            "issuer": "0001",            
            "accountType": "CACC",        
            "documentNumber": "12345678901", 
            "name": "John Doe"      
        }
    },
    "externalId": "externalId"
}

PIX

{
    "destinationType": {
        "type": "CHAVE PIX",
        "chavePix": "+5512575253111",     // Required: PIX key (CPF/CNPJ, email, phone, or random key)
        "documentNumber": "12345678901"   // Optional: Owner CPF/CNPJ for verification
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "BRAZIL",
        "currency": "BRL",
        "destinationType": {
            "type": "CHAVE PIX",
            "chavePix": "+5512575253111", 
            "documentNumber": "12345678901"
        }
    },
    "externalId": "externalId"
}

Brazil PIX Keys

When providing documentNumber with PIX, a verification is performed to ensure the document matches the PIX key

Brazil Account Types

CACC: Current Account
SVGS: Savings Account
TRAN: Transfer Account
SLRY: Salary Account

Chile

Currency Support

CLP (Chilean Peso)

Chile Account

{
    "destinationType": {
        "type": "ACCOUNT_CHILE",
        "currency": "CLP",
        "bankCode": "001",              // Required: Owner account bank
        "accountType": "RUT",           // Required: Account type,  Values: CC, SVGS, VISTA, RUT, SLRY
        "accountNumber": "00123456789", // Required: Account number
        "documentType": "RUT",          // Required: Document type, Values: RUT, RUN, PAS, CE
        "documentNumber": "12345678-9", // Required: Owner account document
        "name": "John Doe"              // Required: Owner account name
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "CHILE",
        "currency": "CLP",
        "destinationType": {
            "type": "ACCOUNT_CHILE",
            "currency": "CLP",
            "bankCode": "001",
            "accountType": "RUT",
            "accountNumber": "00123456789",
            "documentType": "RUT",
            "documentNumber": "12345678-9",
            "name": "John Doe"
        }
    },
    "externalId": "externalId"
}

Mexico

Currency Support

MXN (Mexican Peso)
USD (US Dollar)

Clabe

{
     "destinationType": {
         "type": "CLABE",   
         "clabe": "032180000118359719"  // Required: 18-digit CLABE number,
         "reference": "test_reference"
     }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "MEXICO",
        "currency": "MXN",
        "destinationType": {
            "type": "CLABE",
            "clabe": "032180000118359719",
            "reference": "test_reference"
        }
    },
    "externalId": "externalId"
}

Paraguay

Currency Support

PYG (Paraguayan Guaraní)

Paraguay account

{
     "destinationType": {
       "type": "ACCOUNT_PARAGUAY",
       "bankCode": "44",                // Required: Bank code from bank codes list
       "name": "John Doe",              // Required: Beneficiary account name
       "accountNumber": "123456789",    // Required: Beneficiary account number  
       "documentType": "CI",            // Required: CI, PAS, CRP, CRC, RUC, DNI
       "documentNumber": "6532142"      // Required: Document number (format depends on document type)
     }
}

Document number format

If you select RUC, the document number must have a check digit (example 80221430-7), if CI is selected, the document number does not have a check digit (example 6532142).

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "PARAGUAY",
        "currency": "PYG",
        "destinationType": {
            "type": "ACCOUNT_PARAGUAY",
            "bankCode": "44",                  
            "name": "John Doe",          
            "accountNumber": "123456789",      
            "documentType": "CI",            
            "documentNumber": "6532142"
        }
    },
    "externalId": "externalId"
}

Paraguay Bank Codes

Bank Code	Bank Name
1	BANCO CENTRAL DEL PARAGUAY
2	BANCO NACIONAL DE FOMENTO
3	BANCO DE LA NACION ARGENTINA
4	BANCO GNB PARAGUAY S.A.
5	BANCO DO BRASIL S.A.
6	CITIBANK N.A.
8	SUDAMERIS BANK S.A.E.C.A.
17	BANCO ITAU PARAGUAY S.A.
20	BANCO CONTINENTAL S.A.
30	BANCO BASA (ex - Amambay)
39	VISION BANCO S.A.E.C.A.
40	BANCO RIO S.A.E.C.A. (Ex - Itapua)
41	BANCO FAMILIAR S.A.E.C.A.
42	BANCO ATLAS
43	BANCOP S.A.
44	INTERFISA BANCO
6557	FINANCIERA UENO S.A.E.C.A.
6558	CRISOL Y ENCARNACION FINANCIERA S.A.
6559	FINLATINA S.A. DE FINANZAS
6560	FINANCIERA PARAGUAYO-JAPONESA S.A.E.C.A.
6561	FINANCIERA EXPORTADORA PARAGUAYA S.A.
6564	SOLAR S.A. DE AHORRO Y PRESTAMO PARA LA VIVIENDA
6565	TU FINANCIERA S.A.
7079	FIC S.A. DE FINANZAS

Peru

Currency Support

PEN (Peruvian Sol)

Peru account

{
    "destinationType": {
        "type": "ACCOUNT_PERU",
        "currency": "PEN",
        "bankCode": "002",                        // Required: Bank code
        "accountType": "CC",                      // Required: Account type, Values: CC, SVGS, EFE
        "accountNumber": "0011-0123-0200345678",  // Optional: Standard bank account number
        "cciNumber": "011-123-000200345678-12",   // Optional: 20-digit Interbank account code
        "documentType": "RUC",                    // Required: Document type, Values: RUC, DNI, PAS, CE
        "documentNumber": "12345678",             // Required: ID number based on document type
        "name": "John Doe",                       // Required: Name of account holder
        "state": "LIMA",                          // Required: State
        "email": "john@example.com"               // Optional: Contact email
    }
}

Full request example

{
    "amount": 100,
    "destinationAccount": {
        "country": "PERU",
        "currency": "PEN",
        "destinationType": {
            "type": "ACCOUNT_PERU",
            "currency": "PEN",
            "bankCode": "002",
            "accountType": "CC",
            "accountNumber": "0011-0123-0200345678",
            "cciNumber": "011-123-000200345678-12",
            "documentType": "RUC",
            "documentNumber": "12345678",
            "name": "John Doe",
            "state": "LIMA",
            "email": "john@example.com"
        }   
    },
    "externalId": "externalId"
}

Callbacks

The withdraw callback will be sent to the merchant transaction status webhook URL if no callbackUrl is provided
To specify a different callback destination, include callbackUrl in the request body

Reference Tables

Currency Codes

Code	Name
ARS	Argentine Peso
BRL	Brazilian Real
CLP	Chilean Peso
MXN	Mexican Peso
USD	US Dollar
PYG	Paraguayan Guarani
PEN	Peruvian Sol

Country Codes

Code
ARGENTINA
BRAZIL
CHILE
MEXICO
PARAGUAY
PERU

08 January 2026