Developer Portal

Welcome to the Assembly Payments developer portal. Here you’ll find comprehensive guides and documentation to help you start working with Assembly as quickly as possible, as well as support if you get stuck. Let's get started!

Platforms & Marketplaces Point of Sale

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

email

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

email

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 1pending_check1, 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 about a month ago


Onboarding a pay-out user


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.