Client-Hosted Recipient Onboarding

Clients may opt to host the entire recipient onboarding process including W9 information collection and payout method selection and transmit to Bold via API calls.

There are three implementation steps:

  1. Display link to Bold Terms of Service
  2. Implement data collection and transmission
  3. Provide screenshots to Bold for review


Display link to Bold Terms of Service

In the signup flow, include an opt-in checkbox with the following language: 

"Payment processing services are provided by Bold Financial Technologies, Inc. (the ‘Payment Processor’) and are subject to the Bold Recipient Terms, which constitute a legal agreement between you and the Payment Processor. By agreeing to these terms or continuing to operate an account, you agree to be bound by the Bold Recipient Terms, as the same may be modified by the Payment Processor from time to time."

"Bold Recipient Terms" should link to ""


Implement Data Collection and Transmission

Collect recipient W9 information and payout preferences. W9 information should include: Recipient Type (company or individual), company name (if applicable), first/last name (if applicable), email, address, city, state, postal code and tax ID.

Payout preferences will depend on payout method selected:

  • Bank: bank routing number (9 digits), bank account number
  • Check: address, city, state, postal code
  • PayPal: email address associated with PayPal account

Recipient information is transmitted to Bold via the Add Recipient API call.

Clients must include 3 extra API parameters to implement hosted onboarding: skip_onboarding=true, accepted_terms=true and accepted_terms_ip=[recipient's IP address].

POST /v1/recipients

  "remote_id": "",
  "first_name": "Jacob",
  "last_name": "Smith",
  "email": "",
  "type": "individual",
  "address": "123 Main St",
  "city": "San Francisco",
  "state": "CA",
  "postealcode": "94133",
  "country": "US",
  "skip_onboarding": "true",
  "accepted_terms": "true",
  "accepted_terms_ip": ""

Payout preferences are transmitted to Bold via the Add Wallet API call:

POST /v1/wallets

  "remote_id": "",
  "type": "bank",
  "routing_number": "021000021",
  "account_number": "42340005737"

More information about Bold's API suite is available in the Bold Docs.


Provide Screen Shots to Bold for Review

Finally, clients are to submit screen shots of the key onboarding pages to Bold at for review and approval.



Have more questions? Submit a request


Please sign in to leave a comment.