Seller Onboarding Forms

Seller Onboarding Forms

Save time onboarding sellers by using our Onboarding Forms.

Finix's low-code / no-code Onboarding Forms are a fast and flexible way to onboard your sellers. Creating and filling out the form takes just minutes, helping your sellers start processing payments as fast as possible. You can create an Onboarding Form directly from Finix's dashboard, as well as with our APIs.

Deleting Onboarding Forms is unavailable

Our product does not support deleting onboarding forms. You can create a new one if you would like the merchant to start again.

Finix's Onboarding Forms are purpose-built to make onboarding your sellers as easy as possible:

Onboarding Form Data

Our Onboarding Forms collect 5 key pieces of data from your sellers:

  1. Seller consent: Finix collects your sellers' consent to both Finix's terms as well as your own terms.
  2. Business information: Finix collects data about your seller's business, such as their business name.
  3. Owner information: Finix collects data about your seller's control person, such as their personal name.
  4. Processing information: Finix collects data about your seller's processing information, such as volumes.
  5. Bank account information: Finix collects details about your seller's bank account for their payouts.

Managing Onboarding Forms with Finix's Dashboard

Branding Onboarding Forms

Finix lets you brand your Onboarding Forms with your company's name, logo, and colors. To apply your branding, visit Settings > Company > Branding > Onboarding Forms on your Finix dashboard. From there, you can set your business name, the logo to use on the form's header, and the color to use for the form's header. You can preview your branding by creating an Onboarding Form in your Sandbox account, or refreshing an existing Onboarding Form.

By default, our Onboarding Form is branded dark blue with no logo. For more information, see White Labeling and Customizing Finix Dashboards.

Creating Onboarding Forms

To create an Onboarding Form with Finix's dashboard, visit Merchants > Onboarding Forms and select Create New Form. From there, we will collect these details to create the form:

Field Description
Country Your merchant's business country
Merchant Name Your merchant's business name
Link Expiration Time (Days) Time until your Onboarding Form expires
Fee URL Link to webpage explaining your payment processing fees
Return URL Link to webpage for your merchants to route after completing their Onboarding Form
Terms of Service URL Link to webpage with your Terms of Service
Expired Session URL Link to webpage for your merchants to route should the Onboarding Form expire
Max Transaction Amount (Card) Maximum transaction amount for your merchant's card payment processing
Max Transaction Amount (ACH) Maximum transaction amount for your merchant's ACH payment processing
Payment Processor Payment processor for your merchant's processing

After creating the Onboarding Form, copy the link to send to your merchant. That's it – your merchant is ready to apply to Finix, with no additional action from your team. Once your merchant submits their Onboarding Form, Finix will create their Merchant account and review their information.

Viewing Onboarding Forms

View all your Onboarding Forms in your Finix dashboard under Merchants > Onboarding Forms. You can view and filter by form status.

Select an Onboarding Form to re-copy the form's link under Actions, as well as view all the information your Merchant has saved to the form while filling it out. You can generate a new URL link if the Onboarding Form's Status is In Progress.

Submitted Onboarding Forms

After your seller submits their Onboarding Form, Finix will mark it Completed and automatically create your seller's Merchant account. After the review process, your seller's Merchant account will be Approved and ready to accept payments. This process often takes just minutes.

Should Finix require more information from your sellers during our review, their Merchant account and Onboarding Form will both move to an Update Requested state. To make the update process as easy as possible, your sellers can use their original Onboarding Form to provide the requested information. After resending your sellers their Onboarding Form link, no additional action is required from your team – Finix will automatically re-review your seller after they submit the requested updates.

Lifecycle event Onboarding Form Merchant Account
Onboarding Form Created In Progress —
Onboarding Form Submitted Completed Provisioning
Merchant Approved Completed Approved
Merchant Rejected Completed Rejected
Updates Requested Update Requested Update Requested
Updates Submitted Completed Provisioning

Managing Onboarding Forms with Finix's API

Should you wish to create Onboarding Forms in bulk or directly from your application, you can use the Onboarding Forms API. Finix lets you prefill as many or as few fields as you'd like, and provides a link your seller can use to access the form.

Required Data

Finix requires these fields to create an Onboarding Form:

Field Type Description
expired_session_url String Link to webpage for your merchants to route should the Onboarding Form expire
fee_details_url String Link to webpage explaining your payment processing fees
max_transaction_amount Integer Maximum transaction amount for your merchant's card payment processing
processor Enum Payment processor for your merchant's processing
return_url String Link to webpage for your merchants to route after completing their Onboarding Form
terms_of_service_url String Link to webpage with your Terms of Service

Prefilling Fields

Beyond setting the required fields, you may prefill as many other fields as you'd like on the Onboarding Form. This includes the country, as well as all the fields under entity, additional_underwriting_data, associated_entities, and payment_instruments.

Form Link

In the response, Finix provides a link for your seller to access and complete the Onboarding Form (link_url). Should the form's link expire, use the Onboarding Forms Link API to create a new one.

Request Examples

Request

curl "https://finix.sandbox-payments-api.com/onboarding_forms" \
    -H "Content-Type: application/json" \
    -H "Finix-Version: 2022-02-01" \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
    -d '{
        "onboarding_data": {
            "country": "USA",
            "entity": {
                "title": "CEO",
                "first_name": "John",
                "last_name": "Smith",
                "email": "owner@democompany.com",
                "business_name": "Demo Company, LLC",
                "business_type": "LIMITED_LIABILITY_COMPANY",
                "doing_business_as": "Demo Company",
                "phone": "12223334444",
                "business_phone": "12223334444",
                "mcc": "4900",
                "url": "https://www.democompany.com",
                "ownership_type": "PRIVATE",
                "default_statement_descriptor": "DEMOCOMPANY",
                "annual_card_volume": 1000000,
                "principal_percentage_ownership": 75,
                "tax_id": "111223333",
                "business_tax_id": "112222222",
                "has_accepted_credit_cards_previously": false
            },
            "additional_underwriting_data": {
                "refund_policy": "NO_REFUNDS",
                "card_volume_distribution": {
                    "ecommerce_percentage": 100,
                    "card_present_percentage": 0,
                    "mail_order_telephone_order_percentage": 0
                },
                "average_ach_transfer_amount": 20000000,
                "average_card_transfer_amount": 20000,
                "annual_ach_volume": 20000000,
                "business_description": "CONSUMER",
                "volume_distribution_by_business_type": {
                    "other_volume_percentage": 0,
                    "person_to_person_volume_percentage": 0,
                    "business_to_business_volume_percentage": 90,
                    "business_to_consumer_volume_percentage": 10,
                    "consumer_to_consumer_volume_percentage": 0
                }
            },
            "associated_entities": [
                {
                    "title": "CFO",
                    "first_name": "Jane",
                    "last_name": "Doe",
                    "email": "jane@democompany.com",
                    "phone": "12223334444",
                    "personal_address": {
                        "city": "Bellevue",
                        "country": "USA",
                        "line1": "4848 84th St",
                        "postal_code": "98032",
                        "region": "WA"
                    },
                    "dob": {
                        "day": 13,
                        "month": 4,
                        "year": 1985
                    },
                    "principal_percentage_ownership": 25,
                    "tax_id": "111223333"
                }
            ],
            "payment_instruments": {
                "account_number": "783465874368",
                "account_type": "CHECKING",
                "bank_code": "123456789",
                "country": "USA",
                "currency": "USD",
                "name": "JOE BANKER",
                "type": "BANK_ACCOUNT"
            },
            "max_transaction_amount": 100000,
            "ach_max_transaction_amount": 100000
        },
        "merchant_processors": [
            {
                "processor": "DUMMY_V1"
            }
        ],
        "onboarding_link_details": {
            "expiration_in_minutes": 10080,
            "expired_session_url": "https://www.democompany.com/login",
            "fee_details_url": "https://www.democompany.com/fee_details",
            "return_url": "https://www.democompany.com/home",
            "terms_of_service_url": "https://www.democompany.com/ToS"
        }
    }'

Response

{
    "id": "obf_iZt2Xu51dBsG7XtAivaGfB",
    "onboarding_data": {
        "entity": {
            "title": "CEO",
            "first_name": "John",
            "last_name": "Smith",
            "email": "owner@democompany.com",
            "business_name": "Demo Company, LLC",
            "business_type": "LIMITED_LIABILITY_COMPANY",
            "doing_business_as": "Demo Company",
            "phone": "12223334444",
            "business_phone": "12223334444",
            "mcc": "4900",
            "url": "https://www.democompany.com",
            "ownership_type": "PRIVATE",
            "default_statement_descriptor": "DEMOCOMPANY",
            "annual_card_volume": "1000000",
            "principal_percentage_ownership": "75",
            "tax_id": "*****3333",
            "business_tax_id": "*****2222",
            "has_accepted_credit_cards_previously": false,
            "personal_address": {
                "line1": "123 Boren Ave",
                "city": "Seattle",
                "region": "WA",
                "postal_code": "98040",
                "country": "USA"
            },
            "business_address": {
                "line1": "123 Bellevue Way",
                "city": "Bellevue",
                "region": "WA",
                "postal_code": "98039",
                "country": "USA"
            },
            "dob": {
                "day": 13,
                "month": 4,
                "year": 1982
            },
            "incorporation_date": {
                "day": 9,
                "month": 3,
                "year": 2018
            }
        },
        "associated_entities": [
            {
                "title": "CFO",
                "first_name": "Jane",
                "last_name": "Doe",
                "email": "jane@democompany.com",
                "phone": "12223334444",
                "personal_address": {
                    "line1": "4848 84th St",
                    "city": "Bellevue",
                    "region": "WA",
                    "postal_code": "98032",
                    "country": "USA"
                },
                "dob": {
                    "day": 13,
                    "month": 4,
                    "year": 1985
                },
                "principal_percentage_ownership": 25,
                "tax_id": "*****3333"
            }
        ],
        "payment_instruments": {
            "name": "JOE BANKER",
            "bank_code": "123456789",
            "account_number": "*****4368",
            "account_type": "CHECKING",
            "type": "BANK_ACCOUNT",
            "country": "USA",
            "currency": "USD"
        },
        "additional_underwriting_data": {
            "refund_policy": "NO_REFUNDS",
            "average_ach_transfer_amount": 20000000,
            "average_card_transfer_amount": 20000,
            "merchant_agreement_ip_address": null,
            "merchant_agreement_accepted": null,
            "merchant_agreement_timestamp": null,
            "merchant_agreement_user_agent": null,
            "credit_check_timestamp": null,
            "credit_check_user_agent": null,
            "annual_ach_volume": 20000000,
            "business_description": "CONSUMER",
            "volume_distribution_by_business_type": {
                "other_volume_percentage": 0,
                "person_to_person_volume_percentage": 0,
                "business_to_business_volume_percentage": 90,
                "business_to_consumer_volume_percentage": 10,
                "consumer_to_consumer_volume_percentage": 0
            },
            "card_volume_distribution": {
                "ecommerce_percentage": 100,
                "card_present_percentage": 0,
                "mail_order_telephone_order_percentage": 0
            },
            "amex_marketing_consent": null
        },
        "max_transaction_amount": 100000,
        "ach_max_transaction_amount": 100000,
        "country": "USA",
        "associated_files": []
    },
    "merchant_processors": [
        {
            "processor": "DUMMY_V1"
        }
    ],
    "onboarding_link_details": {
        "return_url": "https://www.democompany.com/home",
        "expired_session_url": "https://www.democompany.com/login",
        "fee_details_url": "https://www.democompany.com/fee_details",
        "terms_of_service_url": "https://www.democompany.com/ToS",
        "expiration_in_minutes": 10080
    },
    "onboarding_link": {
        "expires_at": "2024-11-15T05:23:21.208Z",
        "link_url": "https://sandbox.payments-dashboard.com/merchant-onboarding?formId=obf_iZt2Xu51dBsG7XtAivaGfB&applicationId=APgPDQrLD52TYvqazjHJJchM&bearerToken=eyJhbGciOiJIUzUxMiJ9.eyJvbmJvYXJkaW5nX2Zvcm1faWQiOiJvYmZfaVp0Mlh1NTFkQnNHN1h0QWl2YUdmQiIsImZlZV9kZXRhaWxzX3VybCI6Imh0dHBzOi8vd3d3LmRlbW9jb21wYW55LmNvbS9mZWVfZGV0YWlscyIsImV4cGlyZWRfc2Vzc2lvbl91cmwiOiJodHRwczovL3d3dy5kZW1vY29tcGFueS5jb20vbG9naW4iLCJtZXJjaGFudF9hY2hfbWF4X3RyYW5zYWN0aW9uX2Ftb3VudCI6MTAwMDAwLCJpc3MiOiJodHRwczovL3d3dy5maW5peC5jb20iLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly93d3cuZGVtb2NvbXBhbnkuY29tL1RvUyJ9.g0fa_AG3tsKgvqZST7UrvrIZxrzqFIw6S9qhxJrs1eb-OPGZg0zWWBsNhpqD8QAk3eGEQhjBo2G1lHo9EUBBSg"
    },
    "status": "IN_PROGRESS",
    "identity_id": null,
    "application_id": "APgPDQrLD52TYvqazjHJJchM",
    "created_at": "2024-11-08T05:23:21.190954Z",
    "updated_at": "2024-11-08T05:23:21.190954Z",
    "tags": {}
}

Onboarding Form Identity Verification

To mitigate fraud and identity theft, Finix requires government IDs and selfie photos from merchants submitting Onboarding Forms. This verification step ensures that the actual control owner of a merchant’s business is submitting the form, preventing unauthorized access.

Collecting government IDs and selfies is an effective tool for mitigating fraud and identity theft. If you have concerns about Finix collecting and verifying this information, please contact your Finix representative.

Finix integrates Persona to securely collect government IDs and selfies within the Onboarding Form. The control owner must complete this step before submitting the form. The verification process works on any device with a camera, and merchants can switch to another device if needed.

Next Steps

Next, learn how to handle update requests and subscribe to lifecycle notifications to move your sellers through the onboarding process.