Onboarding a pay-out user
A pay-out user (also sometimes referred to as a "seller" or a "merchant") in Assembly is a user that will be receiving funds. There are a different set of requirements for a user that acts as a pay-out user, versus a user that acts as a pay-in user. In order for any pay-out user to accept funds, they must undergo user verification and be underwritten as a merchant. As a platform, you must pass through enough information for Assembly to use for these verification purposes, so that funds can be disbursed to them. For more information on the verification process, please see our Verification workflow.
How it works
Required Information
There are different data requirements for pay-out users who are located in different countries, as well as if they are a person or a company. A pay-out user must pass user verification from Assembly in order to receive money.
There are different thresholds and rules for these checks that are carried out as a pay-out user's total disbursement volume increases. To perform these checks, a set of information is required of users, dependent on the location and entity type of the user.
There is a minimum set of information that is required to create a pay-out user. Passing as much information as possible will help create a strong user profile on your platform, and also help Assembly sign your seller’s up quickly, with as little intervention as needed.
Please note that US pay-out user must provide either a government number or a tax number. Otherwise, they will not trigger the verification process.
API requirements
The following are the required information, at minimum, for you to create a pay-out user. You can update the seller information at another time, in case you don’t have the complete information at hand.
Information required for companies:
If your user is a company, the User information provided should be the primary contact for that company.
| Required user information | Required bank information | Required company information |
|---|---|---|
| user_id | name | |
| first_name | bank_name | legal_name |
| last_name | account_name | tax_number* |
| addressline_1 | routing_number | address_line1 |
| city | account_number | city |
| state | account_type | state |
| zip (postcode) | holder_type | zip |
| country | country | phone |
| dob | country | |
| government_number* (Required for USA only) |
Information required for individuals:
The following is the required information for your pay-out users to receive payments.
| Required user information | Required bank information | Required company information |
|---|---|---|
| id | user_id | |
| bank_name | ||
| first_name | account_name | |
| last_name | routing_number | |
| addressline_1 | account_number | |
| city | account_type | |
| state | holder_type | |
| zip (postcode) | country | |
| country | ||
| dob | ||
| government_number* (Required for USA only) |
* Refer to the information below for applicable information.
Government and tax numbers
- USA
government_number- Last four digits of SSN (full SSN required in some circumstances)tax_number- EIN
Walkthrough
Create a merchant
Use Create User to create your pay-out user within Assembly. Pass the required information, along with any other additional information to create a strong user profile. Once the user has been created, the verification state should be pending. This means that not all required information has been provided yet.
Create a bank account
Use Create Bank Account to create your User’s Bank Account within Assembly. Once the bank account has been added for your pay-out user, the user’s verification state should transition to pending_check, or approved, depending on the risk rules configured for your platform.
Set the disbursement account
Use Set User Disbursement Account to set up the merchant's pay-out account.
Pay-out user can receive funds using different pay-out options. Assembly supports Domestic Bank Transfers, International Wire Transfers and Digital Wallets.
Disbursement accounts are an essential part of the merchant's profile since without it, the merchant cannot get paid. Thus, it's part of user verification requirements.
Receive payments
Once the user has been approved and the disbursement account set, they can start receiving payments to their disbursement account destination.
Updated over 3 years ago