External Accounts
These accounts are not created and managed by Walapay, but are instead existing bank accounts, eWallet accounts, or digital asset wallets (e.g., an HSBC bank account that an Individual has for their own personal use).
Required fields
For the list of required fields by country, please check our requirements by region page.
External Bank Account Creation
Depending on the country, when an external bank account is created, it may require a very short (~10 seconds) validation by our banking provider before it is useable. In this scenario, the response of the request will include a status of PENDING for the account. Through the use of our webhooks, you can subscribe to the "account.updated" event to receive an update when the account has been APPROVED; at which point, you will be able to send payments to this account.
curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_BANK_ACCOUNT",
"currencyCode": "USD",
"bank": {
"name": "U.S. Bank",
"accountNumber": "123456789",
"routingNumber": "021000089",
"type": "CHECKING",
"address": {
"streetLine1": "425 Walnut Street",
"city": "Cincinnati",
"stateOrProvince": "OH",
"postalCode": "45202",
"countryCode": "US"
}
},
"accountHolder": {
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"address": {
"streetLine1": "123 Main Street",
"city": "Cincinnati",
"stateOrProvince": "OH",
"postalCode": "45202",
"countryCode": "US"
},
"type": "INDIVIDUAL"
}
}'curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_BANK_ACCOUNT",
"currencyCode": "PHP",
"bank": {
"name": "Union Bank of the Philippines",
"accountNumber": "1234567890",
"type": "SAVING",
"address": {
"streetLine1": "Ayala Avenue",
"city": "Makati",
"stateOrProvince": "Metro Manila",
"postalCode": "1226",
"countryCode": "PH"
}
},
"accountHolder": {
"firstName": "Juan",
"lastName": "Dela Cruz",
"email": "[email protected]",
"address": {
"streetLine1": "456 Quezon Street",
"city": "Quezon City",
"stateOrProvince": "Metro Manila",
"postalCode": "1100",
"countryCode": "PH"
},
"type": "INDIVIDUAL"
}
}'curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_BANK_ACCOUNT",
"currencyCode": "BRL",
"bank": {
"name": "Banco do Brasil",
"pixCode": "+5511998765432",
"type": "CHECKING",
"address": {
"streetLine1": "Setor Bancário Sul",
"city": "Brasília",
"stateOrProvince": "DF",
"postalCode": "70070-900",
"countryCode": "BR"
}
},
"accountHolder": {
"firstName": "João",
"lastName": "Silva",
"email": "Joã[email protected]",
"address": {
"streetLine1": "Avenida Paulista, 1000",
"city": "São Paulo",
"stateOrProvince": "SP",
"postalCode": "01310-000",
"countryCode": "BR"
},
"type": "INDIVIDUAL",
"taxIdentificationNumber": "39053344705"
}
}'curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_BANK_ACCOUNT",
"currencyCode": "CNH",
"bank": {
"name": "Industrial and Commercial Bank of China",
"accountNumber": "6222021234567890",
"cnapsCode": "CNAPS1234562",
"type": "SAVING",
"address": {
"streetLine1": "55 Fuxingmennei Avenue",
"city": "Beijing",
"stateOrProvince": "Beijing",
"postalCode": "100140",
"countryCode": "CN"
}
},
"accountHolder": {
"firstName": "Li",
"lastName": "Wei",
"email": "[email protected]",
"address": {
"streetLine1": "456 Zhongshan Road",
"city": "Shanghai",
"stateOrProvince": "Shanghai",
"postalCode": "200000",
"countryCode": "CN"
},
"type": "INDIVIDUAL"
}
}'External E-Wallet Account Creation
curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_EWALLET_ACCOUNT",
"currencyCode": "PHP",
"eWallet": {
"name": "GCash",
"accountNumber": "20232249",
"countryCode": "PH"
},
"accountHolder": {
"firstName": "Joseph",
"lastName": "Fajagut",
"email": "[email protected]",
"address": {
"streetLine1": "123 Santo Road",
"city": "Manila",
"stateOrProvince": "Metro Manila",
"postalCode": "1000",
"countryCode": "PH"
},
"type": "INDIVIDUAL"
}
}'External Digital Asset Wallet Creation
Network Selection
Note that in Sandbox, all chains will be converted to their testnet equivalent:
- Polygon --> Polygon Amoy
- Ethereum --> Ethereum Sepolia
- Base --> Base Sepolia
- Solana --> Solana Devnet
Currency Code
Digital Asset Wallets do not take a CurrencyCode parameter.
curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_DIGITAL_ASSET_WALLET",
"digitalAssetWallet": {
"address": "0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5",
"chain": "ETHEREUM"
},
"accountHolder": {
"firstName": "Joseph",
"lastName": "Fajagut",
"email": "[email protected]",
"address": {
"streetLine1": "123 Santo Road",
"city": "Manila",
"stateOrProvince": "Metro Manila",
"postalCode": "1000",
"countryCode": "PH"
},
"type": "INDIVIDUAL"
}
}'curl --request POST \
--url 'https://sandbox-api.walapay.io/v1/accounts/<customerId>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'X-Api-Key: fa15de08-f1af-4c41-a74b-2302b6785c13' \
--data '{
"type": "EXTERNAL_DIGITAL_ASSET_WALLET",
"digitalAssetWallet": {
"address": "0x95222290DD7278Aa3Ddd389Cc1E1d165CC4BAfe5",
"chain": "POLYGON"
},
"accountHolder": {
"firstName": "João",
"lastName": "Silva",
"email": "Joã[email protected]",
"address": {
"streetLine1": "123 Rua Santo",
"city": "São Paulo",
"stateOrProvince": "SP",
"postalCode": "01000-000",
"countryCode": "BR"
},
"type": "INDIVIDUAL"
}
}'Updated about 1 month ago