Guides Use cases API Changelog
  1. Use case quick start

Small business

Moov is your single vendor for running and managing a modern payment solution that will reduce costs for your small business.

This guide focuses on the quickest and easiest way to get started with the features of Moov we think you'll find most useful running a small business. Onboard customers to a secure payment platform, add surcharging for card transactions, send payment link QR codes, and smoothly handle refunds and disputes.

Moov offers a variety of integration options to get started. Use Drops or the Dashboard UIs for a low to no-code solution, or choose the API or one of many SDKs for more complex integrations.

For the purposes of this guide, we'll provide Dashboard and API examples.

Onboard customers

As you move through the onboarding process to create Moov accounts, some data is required while other data is optional. To view our full onboarding guides, visit the Dashboard or main onboarding guides.

Onboarding data Required
Capabilities ✓
Fee plan ✓
Scopes ✓
Return URL ×
Terms of service URL ×
Prefilled data ×

Capabilities determine what each Moov account can do, such as receiving transfers, or sending money to others. For risk and fraud protection purposes, we require detailed information when requesting capabilities. For example, we'll request more details if an account wants to collect funds than we would for an account receiving funds.

Pricing & fee plans can be assigned to one account or reused for many accounts. New accounts must agree to and accept the fee plan before it can go into effect. Moov offers two types of plans:

  • Cost plus: With a cost plus plan, card networks’ interchange fees and Moov’s processing markup are passed along to the account. Cost plus plans are beneficial for accounts 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 account. Flat plans are beneficial for accounts with a low transaction volume that prefer a predictable solution over lowering cost as much as possible.

Scopes are used to determine what can be done with the account once it's onboarded. For example, the /accounts.read scope provides access to view all connected user accounts and the /accounts/{accountID}/files.read scope provides access to view or upload files associated with a Moov account.

Read more on required data in our documentation:

Capabilities Fee plans Scopes

Moov will send the terms of service platform agreement as part of the onboarding process through the Dashboard. Everyone with a Moov account must agree to and accept the terms of service before using Moov.

The following clip demonstrates how to create a new onboarding link in the Dashboard:

Read more about accounts and onboarding in our documentation:

Accounts Onboarding links

Use form shortening

Use the enrichment API to find publicly available information to autofill form fields based on an email address. With the enrichment API you can:

  • Autocomplete addresses
  • Get avatars
  • Look up bank by routing number
  • List industries
  • Enrich business profile

If you're using a Moov.js integration, you can use Moov's pre-built Drops UI for form shortening. Read more in the Moov.js documentation:

Moov.js Composable Drops

Payment links are a secure way to collet payments from customers. Set up a transaction with a custom amount, or choose a product from your catalog. You can also add tip options or a surcharge fee (as shown in the example).

Payment links can be shared as a URL or Qr code via email, SMS, or social media. When customers click on a link, they can pay using a credit card, debit card, or bank account.

When surcharging is enabled, you must follow card brand caps, as well as federal and state regulations. See our surcharge guide for details on compliance, disclosures, and regulations. Note - surcharging requires a review and registration process with Moov and some card brands before it can be enabled on accounts.

To add a surcharge to a credit card transaction, go to Checkout add-ons, toggle surcharging on, and enter an amount.

Toggle surcharging on

Dashboard payment links Payment links Payment link API Surcharges

Facilitate in-person payments

Moov supports in-person payments via QR codes and Tap to Pay on iPhone and Android.

QR codes

QR codes are generated through the payment links process. Once a payment link has been created in the Dashboard, you'll be presented with a URL and QR code to copy and send. If you're using the API, the payment link code will be in the response. You can append the code to the payment link URL https://moov.link/ and send it to customers.

Sharable link and QR code

Tap to Pay

Tap to Pay on iPhone and Android involves integrating with Moov's iOS SDK, MoovKit and Moov's Android SDK.

Tap to Pay on iPhone is compatible with devices that meet the following criteria:

  • iPhone XS or newer
  • iOS 16.0+ (US)
  • Latest iOS version recommended for optimal performance

To set up Tap to Pay on iPhone, you'll need to go through the following steps:

  • Initialize with MoovKit
  • Request entitlement from Apple
  • Review Apple's guidelines
  • Implement a terminal configuration provider to initialize MoovKit
  • Register your app with Moov
  • Accept Apple's terms and conditions per merchant identifier
Payment links Tap to Pay on iPhone Tap to Pay on Android

Handle reversals & refunds

Moov's reversal process offers a robust solution for returning funds to a cardholder, regardless of the current state of the transfer. When possible, a reversal cancels the transfer, reversing the authorization and swiftly returning funds. If a reversal is not possible, a refund is initiated instead.

Moov automatically moves your request into the reversal or refund flow depending on settlement status and type, such as a full or partial refund.

For ACH transfers, depending on settlement status, you also have the option of cancelling the ACH transfer directly. If a transfer is cancelable, you will have a Cancel option within the Dashboard.

Read more about reversals, refunds, and cancellations in our documentation:

Reversals in the Dashbaord Reversals ACH cancellations Reversals API

Handle disputes

The Dashboard will notify you of any disputes that come in and the deadline in which they will need to be handled. You can choose to accept the dispute and facilitate a refund, or challenge the dispute by submitting evidence.

Within the Dashboard, you can view, accept, challenge, delete, and update disputes, as well as view, upload, and update dispute evidence. Moov currently supports RDR (Visa Rapid Dispute Resolution) decisioned pre-disputes and chargebacks from all card networks.

To accept the dispute, click the Refund button and follow the refund procedure.

Read more about disputes in our documentation:

Card disputes Disputes in the Dashboard Disputes API.

Other resources

Test mode Dashboard Webhooks API SDKs