Create withdraw request v2

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

When a withdraw request is received, the system verifies the available balance and checks for any pending withdrawals. Pending withdrawals temporarily reserve a portion of the merchant's balance until the request is either approved or rejected.

Note: For BankTransfer withdrawals, each country may require a different type of request to be submitted. The specific requirements for your country can be found in the right-side menu.

/merchant/v2/withdraw/init

Request parameters

{
  "withdrawalMethod": "BankTransfer",
  "amount": 16.0,
  "callbackUrl": "example",
  "externalId": "example",
  "countryCode": "example",
  "currency": "example",
  "destinationAccount": {
    "reference": "example",
    "destinationType": {
      "type": "example",
      "alias": "example",
      "cbu": "example",
      "ispb": "example",
      "number": "example",
      "issuer": "example",
      "accountType": "example",
      "documentNumber": "example",
      "name": "example",
      "chavePix": "example",
      "bankCode": "example",
      "bankBranch": "example",
      "accountNumber": "example",
      "documentType": "example",
      "reference": "example",
      "iban": "example",
      "beneficiaryType": "example",
      "beneficiaryFirstName": "example",
      "beneficiaryLastName": "example",
      "beneficiaryCountry": "example",
      "proxyAccount": {
        "beneficiaryAddressLine": "example",
        "beneficiaryCity": "example",
        "beneficiaryCountry": "example",
        "beneficiaryBirthdate": "1970-01-14",
        "beneficiaryEmail": "email@example.com",
        "businessType": "example",
        "businessRegistrationNumber": "example",
        "businessContactName": "example",
        "businessPhoneNumber": "example",
        "businessAddressLine": "example",
        "businessCity": "example",
        "businessCountry": "example"
      },
      "instant": true,
      "sortCode": "example",
      "beneficiaryCity": "example",
      "beneficiaryPostalCode": "example",
      "clabe": "example",
      "cciNumber": "example",
      "state": "example",
      "email": "email@example.com",
      "bban": "example",
      "accountHolderName": "example",
      "walletAddress": "example"
    },
    "customer": {
      "email": "email@example.com",
      "phoneNumber": "example",
      "dateOfBirth": "1970-01-14",
      "firstName": "example",
      "lastName": "example"
    },
    "billingAddress": {
      "city": "example",
      "countryCode": "example",
      "addressLine": "example",
      "postalCode": "example"
    }
  }
}

Responses

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

Examples

Bank Transfer Withdrawal

{
    "withdrawalMethod": "BankTransfer",
    "amount": 1000.00,
    "callbackUrl": "https://example.com/callback",
    "countryCode": "AR",
    "currency": "ARS",
    "destinationAccount": {
        "destinationType": {
            "type": "ACCOUNT_TYPE",
            // fields vary depending on country
        }
    },
    "externalId": "externalId"
}

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,
    "countryCode": "AR",
    "currency": "ARS",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "destinationType": {
            "type": "ALIAS",
            "alias": "ExampleAlias"  
        }
    },
    "externalId": "externalId"
}

CBU

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

Full request example

{
    "amount": 100,
    "countryCode": "AR",
    "currency": "ARS",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "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,
    "countryCode": "BR",
    "currency": "BRL",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "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,
    "countryCode": "BR",
    "currency": "BRL",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "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",
        "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,
    "countryCode": "CL",
    "currency": "CLP",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "destinationType": {
            "type": "ACCOUNT_CHILE",
            "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,
    "countryCode": "MX",
    "currency": "MXN",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "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,
    "countryCode": "PY",
    "currency": "PYG",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "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",
        "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,
    "countryCode": "PE",
    "currency": "PEN",
    "withdrawalMethod": "BankTransfer",
    "destinationAccount": {
        "destinationType": {
            "type": "ACCOUNT_PERU",
            "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"
}

Europe

Currency Support

EUR (Euro)
GBP (Pound Sterling)
PLN (Polish Złoty)

Request fields

{
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",           // Required: Customer's email address
      "phoneNumber": "+1234567890",          // Required: Customer's phone number in international format
      "firstName": "John",                   // Required: Customer's first name
      "lastName": "Doe",                     // Required: Customer's last name
      "dateOfBirth": "1990-01-01"            // Required: Must be 18 years or older
    },
    "billingAddress": {
      "countryCode": "DE",                   // Required: ISO 3166-1 alpha-2 country code
      "city": "Berlin",                      // Required: Billing city
      "addressLine": "1 Mein Strasse",       // Required: Full billing address line
      "postalCode": "12345"                  // Required: Postal or ZIP code
    },
    "destinationType": {
        // Check destination types
    }
  }
}

Destination Types

The destinationType object requires the field type.
Send only one of the following values and provide the required fields for the selected type.

Supported Types

Iban
Bban
SortCode
BankCode
Wallet

Iban

{
  "destinationType": {
    "type": "Iban",
    "accountHolderName": "John Doe",
    "iban": "DE89370400440532013000" // IBAN (uppercase, letters and digits only, max 34 chars)
  }
}

Full request example

{
  "withdrawalMethod": "BankTransfer",
  "amount": 1000,
  "callbackUrl": "https://example.com/callback",
  "externalId": "ext-iban-123",
  "countryCode": "DE",
  "currency": "EUR",
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",
      "phoneNumber": "+1234567890",
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01"
    },
    "billingAddress": {
      "countryCode": "DE",
      "city": "Berlin",
      "addressLine": "1 Mein Strasse",
      "postalCode": "12345"
    },
    "destinationType": {
      "type": "Iban",
      "accountHolderName": "John Doe",
      "iban": "DE89370400440532013000"
    }
  }
}

Bban

{
  "destinationType": {
    "type": "Bban",
    "accountHolderName": "John Doe",
    "bban": "12345678901234567" // BBAN: country-specific bank account number, no spaces
  }
}

Full request example

{
  "withdrawalMethod": "BankTransfer",
  "amount": 1000,
  "callbackUrl": "https://example.com/callback",
  "externalId": "ext-iban-123",
  "countryCode": "DE",
  "currency": "EUR",
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",
      "phoneNumber": "+1234567890",
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01"
    },
    "billingAddress": {
      "countryCode": "DE",
      "city": "Berlin",
      "addressLine": "1 Mein Strasse",
      "postalCode": "12345"
    },
    "destinationType": {
      "type": "Bban",
      "accountHolderName": "John Doe",
      "bban": "12345678901234567"
    }
  }
}

SortCode

{
  "destinationType": {
    "type": "SortCode",
    "accountNumber": "12345678", // account number (usually 8 digits)
    "accountHolderName": "John Doe",
    "sortCode": "123456" // 6-digit bank sort code (digits only)
  }
}

Full request example

{
  "withdrawalMethod": "BankTransfer",
  "amount": 1000,
  "callbackUrl": "https://example.com/callback",
  "externalId": "ext-iban-123",
  "countryCode": "DE",
  "currency": "EUR",
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",
      "phoneNumber": "+1234567890",
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01"
    },
    "billingAddress": {
      "countryCode": "DE",
      "city": "Berlin",
      "addressLine": "1 Mein Strasse",
      "postalCode": "12345"
    },
    "destinationType": {
      "type": "SortCode",
      "accountNumber": "12345678",
      "accountHolderName": "John Doe",
      "sortCode": "123456"
    }
  }
}

BankCode

{
  "destinationType": {
    "type": "BankCode",
    "accountNumber": "12345678",
    "accountHolderName": "John Doe",
    "bankCode": "110022" // Bank code / routing number (digits only, country-specific)
  }
}

Full request example

{
  "withdrawalMethod": "BankTransfer",
  "amount": 1000,
  "callbackUrl": "https://example.com/callback",
  "externalId": "ext-iban-123",
  "countryCode": "DE",
  "currency": "EUR",
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",
      "phoneNumber": "+1234567890",
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01"
    },
    "billingAddress": {
      "countryCode": "DE",
      "city": "Berlin",
      "addressLine": "1 Mein Strasse",
      "postalCode": "12345"
    },
    "destinationType": {
      "type": "BankCode",
      "accountNumber": "12345678",
      "accountHolderName": "John Doe",
      "bankCode": "110022"
    }
  }
}

Wallet

{
  "destinationType": {
    "type": "Wallet",
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e" // the blockchain wallet address
  }
}

Full request example

{
  "withdrawalMethod": "BankTransfer",
  "amount": 1000,
  "callbackUrl": "https://example.com/callback",
  "externalId": "ext-iban-123",
  "countryCode": "DE",
  "currency": "EUR",
  "destinationAccount": {
    "customer": {
      "email": "user@example.com",
      "phoneNumber": "+1234567890",
      "firstName": "John",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01"
    },
    "billingAddress": {
      "countryCode": "DE",
      "city": "Berlin",
      "addressLine": "1 Mein Strasse",
      "postalCode": "12345"
    },
    "destinationType": {
      "type": "Wallet",
      "walletAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
    }
  }
}

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
EUR	Euro

08 January 2026