Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. Guides
  2. Moov accounts

Hosted onboarding

This tutorial will show you how to create an onboarding link to a co-branded form through our secure hosted onboarding process. Send the link to merchants to complete their accounts.

Generate a link to a co-branded onboarding application from the Dashboard or our API. Any existing information you have for merchants, such as names and addresses, can be pre-filled. When you send a link, a secure session is created and merchants are prompted to complete the form and sign up for access to Moov. Merchants can be redirected to your app upon completion.

Co-branded social share image and hosted onboarding form

Co-branded social share image and hosted onboarding form

Merchant experience

Merchants will need to create an account with Moov to access the form. During this process, they’ll give permission for you to move money and perform actions on behalf of their account, and they’ll view and agree to the pricing disclosure for the plan you’ve selected.

Once an account has been created, they can start and pause the session, filling out the form at their convenience. Merchants need to double check any pre-filled information for accuracy.

In addition to basic information, business accounts will be required to provide owners and control officers. The onboarding form supports uploading documents for this purpose.

Business account

Your branding

Hosted onboarding contains several references to your own brand, including:

  • Your logo and company name displayed throughout the onboarding flow
  • Page title and meta description includes your company name
  • Social share image includes your logo
  • Accent colors for both light and dark mode
  • If set, the returnURL will redirect the user to your app upon completion of the form
  • If set, termsOfServiceURL will reference your terms of service within the hosted onboarding flow alongside Moov’s platform agreement and privacy policy

Brand accent colors can be set by navigating to Settings in the Dashboard or with the enrichment API. The return URL and terms of service URL can be set when creating an onboarding link in the Dashboard or with the onboarding API.

Create a link and send a form to merchants to fill out at their convenience. Form links will expire upon completion and attempts by a merchant to access a completed form will result in a 404 error.

Navigate to Accounts in the Dashboard and click the New account button. You will see an option to create an Onboarding link. You can also create a link in the Onboarding links section of the Dashboard. Alternatively, you can create these links via API.

Onboarding link button

Select capabilities

Select a business or individual account type and choose the capabilities for the account. Capabilities allow Moov accounts to receive transfers or send money to other accounts. Each capability will have a set of requirements that need to be met before it can be enabled.

  • Transfer: Authorize debit transfers
  • Wallet: Store funds with Moov
  • Send funds: Send funds to another account
  • Collect funds: (business accounts only): Collect funds from another account
  • Card issuing beta: (business accounts only): Provide a virtual card to a merchant

Select capabilities

Select pricing plan

Select a standard plan, which has a $500 monthly transaction minimum, or set up a custom interchange plan. For some fees, you have the option of choosing an all-in model, or you can also assign specific fees based on fee types.

Once you create a plan, you can assign it to one merchant or reuse it for many merchants. Merchants must agree to and accept the fee plan before it can go into effect.

Fees incur based on billable events. See the pricing guide for details.

Cost plus: With a cost plus plan, card networks’ interchange fees and Moov’s processing markup are passed along to the merchant. Cost plus plans are beneficial for merchants with a high and varied transaction volume that prefer to have more control over fees. Fees are broken down into a more digestible and transparent format.

Flat rate: With a flat rate plan, you can lump all the processing fees together with a flat rate customized for each merchant. Flat plans are beneficial for merchants with a low transaction volume that prefer a predictable solution over lowering cost as much as possible.

Choose billing plan

When you set up a merchant with a fee plan, they will receive a pricing disclosure they need to accept. The pricing disclosure shows the rates for the following:

  • Card acquiring
  • Instant payments (AFT, OCT, RTP)
  • ACH
  • Transaction management fees
  • Platform fees
  • Network fees

Pricing disclosure

Account options

At this time you’ll also decide whether or not to pre-fill any existing merchant data or configure client-side authorization through scopes. If you selected to pre-fill data, enter in basic information for the merchant, such as company name, industry, and address.

Prefill data

Moov will provide a link you can send to merchants. Created links can be found in the Accounts > Onboarding links section if you need to access them again.

Status

You can track whether a merchant has created an account and started to complete the form in the Accounts > Onboarding links section of the Dashboard. The Dashboard will also alert you if newly created accounts have any outstanding capability requirements.

Form status

Summary Beta