Learn how to create Child Accounts.
In This Section
As a Partner of borderless™, you can quickly provide your clients with access to all our premium offerings. To do so a Partner must create Child Accounts. In the Child Account Creation section of the borderless™ Partner API, you will find:
- Definitions for Business and Personal Child Accounts
- How to Create Child Accounts
Definitions
| Term | Definition |
|---|---|
| Partner Account | A Partner account is a type of account that has multiple business clients (such as marketplaces). A Partner account has access to our premium features and can make those services available to their clients. A Partner account has a direct relationship with borderless and signs an Integrated Partner Agreement ("IPA"). Once the IPA is signed, the Partner account can integrate and leverage the borderless™ premium services to grow their business. |
| Child Account | A Child account is a client of a Partner account. A Child account may receive access to the borderless™ services, including payment processing capabilities, indirectly via the Partner account. Through an integration to the borderless™ Partner API, a Partner account may make certain borderless™ services available to their Child accounts. |
| Business Child Account | A Business Child Account is an account created for a business entity with a valid registration number or Tax Identification Number. |
| Personal Child Account | A Personal Child Account is an account created for an individual (natural person) with a valid Tax Identification Number. Please note that at the moment Personal Accounts are unable to make payments. |
Creating Child Accounts
As a Partner of borderless™ you may create Child Accounts to provide customized payment experiences to your clients.
Creating Business Child Accounts
To create BUSINESS type Child accounts follow these steps:
Step 1: Identify and Format Required Onboarding Information
Use the required information endpoint to look up the specific onboarding requirements according to the Country and Account Type. The Country is the Country in which the Child Account resides. Select the Business Account Type for businesses.
Pro Tip
Use the supported countries endpoint under the Reference section of the Payouts API to retrieve the list of countries supported by borderless™.
IMPORTANT
For the Account creation API call to succeed, all data must be provided in a way that conforms with the API format requirements. To confirm the correct data format for each entry parameter, please use the following endpoints:
- Use the Job Title endpoint to retrieve the accepted Job Title inputs and data formatting.
- Use the Business Types endpoint to retrieve the accepted Business Types and data formatting for a country. Ensure that the country of location for the business being onboarded is entered correctly.
- Use the Business industries endpoint to retrieve the accepted Business Industries and data formatting.
- Use the zone codes endpoint to retrieve the accepted Zone Code formatting (for example, state codes in the USA). Please note that each country has unique Zone Codes. For an account creation API call to succeed the Zone Code for the address must be formatted as shown in the Zone Codes endpoint.
Step 2: Create a Child Account
Once all the information has been collected and formatted, use the account creation endpoint (available in the On-Boarding section of this API) to create a Child Account.
Upon successful account creation, borderless™ will provide a successful response that includes (but not limited to):
- Child Account ID
- Child Account @handle
- Child Account Status
borderless™ may also request additional information required for Account Verification. This information may include (but is not limited to): ID upload , Upload Documents for Verification or company officers information. To complete the Compliance process, certain documents are required. These requirements may vary by account type and country. To learn more about Account Verification, please visit the Account Verification page.
After all required Account Verification information has been submitted, the Child Account will undergo a full Compliance Review. borderless™ handles all global compliance requirements, including KYC and AML. Each Child Account undergoes a strict KYC and Compliance process for Account Verification.
Pro Tip
The Child Account ID and @handle are used to identify each borderless™ account and are required to execute API calls on behalf of the Child Account. Please make sure to securely store this information.
Step 3: Account Status
To view the status of a created account use the Retrieve Status of the Account (available in the On-Boarding section of this API). borderless™ provides a unique status for each stage of Child Account Creation. When the status of a created account is VERIFIED, the account is ready to use the borderless™ Services. Please find a table of the various account statuses, definitions, and account permissions, below.
| Status | Definition | Account Permissions |
|---|---|---|
| NOT_SETUP | Registration has been started but has not been completed. | None. This account must complete registration. |
| PENDING | Registration is complete and verified documents have been uploaded. | None. This account is in compliance review. |
| VERIFIED | The account has been verified by compliance. | Full. Account has been approved by compliance and is ready to use the borderless™ Services. |
Creating Personal Child Accounts
To create PERSONAL type Child accounts follow these steps:
Step 1: Identify and Format Required Onboarding Information
Use the required information endpoint to look up the specific onboarding requirements according to the Country and Account Type. The Country is the Country in which the Child Account resides. Select the Personal Account Type for individuals.
Pro Tip
Use the supported countries endpoint under the Reference section of the Payouts API to retrieve the list of countries supported by borderless™.
IMPORTANT
For the Account creation API call to succeed, all data must be provided in a way that conforms with the API format requirements. To confirm the correct data format for each entry parameter, please use the following endpoints:
- Use the zone codes endpoint to retrieve the accepted Zone Code formatting (for example, state codes in the USA). Please note that each country has unique Zone Codes. For an account creation API call to succeed the Zone Code for the address must be formatted as shown in the Zone Codes endpoint.
Step 2: Create a Child Account
Once all the information has been collected and formatted, use the for account creation endpoint (available in the On-Boarding section of this API) to create a Child Account.
Upon successful account creation, borderless™ will provide a successful response that includes (but not limited to):
- Child Account ID
- Child Account @handle
- Child Account Status
borderless™ may also request additional information required for Account Verification. This information may include (but is not limited to): ID upload and Upload Documents for Verification. To complete the Compliance process, certain documents are required. These requirements may vary by account type and country. To learn more about Account Verification, please visit the Account Verification page.
After all required Account Verification information has been submitted, the Child Account will undergo a full Compliance Review. borderless™ handles all global compliance requirements, including KYC and AML. Each Child Account undergoes a strict KYC and Compliance process for Account Verification.
Pro Tip
The Child Account ID and @handle are used to identify each borderless™ account and are required to execute API calls on behalf of the Child Account. Please make sure to securely store this information.
Step 3: Account Status
To view the status of a created account use the Retrieve Status of the Account endpoint (available in the On-Boarding section of this API). borderless™ provides a unique status for each stage of Child Account Creation. When the status of a created account is VERIFIED, the account is ready to use the borderless™ Services. Please find a table of the various account statuses, definitions, and account permissions, below.
| Status | Definition | Account Permissions |
|---|---|---|
| NOT_SETUP | Registration has been started but has not been completed. | None. This account must complete registration. |
| PENDING | Registration is complete and verified documents have been uploaded. | None. This account is in compliance review. |
| VERIFIED | The account has been verified by compliance. | Full. Account has been approved by compliance and is ready to use the borderless™ Services. |
Authentication
Remember that all borderless™ API calls must be Authenticated. To learn more about Authentication, please visit the Authentication page.