Platform Checklist
Use this checklist to ensure a smooth transition when taking your platform live with Finix.
The following are the key aspects platforms need to integrate with to go live with Finix. Completing this checklist ensures your platform is complete and transactions will be processed successfully. Platforms include the following experiences:
Taking your platform live largely depends on the payment experience you plan to build and the engineering resources you have available.
info
Finix for Business users can refer to our Integration Checklist for details on how to build an integration with Finix.
We recommend reviewing our documentation and defining your payment experience before going live. (e.g. will you accept Apple Pay, how will you be alerted about disputes, when will sellers receive payouts, etc.)
The Finix Platform Checklist has the following key categories:
When you're ready to go live,let us know and our team will review your platform for live payment processing.
Account and Login
- Create your sandbox account with Finix.
- Log in and gain access to the Finix Dashboard.
-
Understand Finix's account structure and find your
Application#id
.
Once you've gained access to the Finix Dashboard, it's essential to create API Keys for your developers so they can begin integrating your platform with Finix.
Migration
If you're actively processing payments or have done so in the past, you can migrate data over to Finix to ensure no gaps in availability or billing comes up.
For more details, see Migrating Data with Finix.
Onboarding
You need to be able to onboard the sellers and service providers you sign onto Finix. This includes handling failure flows and onboarding rejections:
- Learn how to onboard sellers
- Depending on the onboarding experience you want to build, you need to follow either our:
Onboarding Forms
Onboarding Forms manages the collection of seller information and the creation of API resources that get manipulated to move funds. Your platform needs to be able to onboard sellers using the form Finix provides and handle any onboarding rejections that come up.
-
Create an
Onboarding Form
. - Redirect users to the onboarding form.
-
Retrieve the created
Identity
,Merchant
,Payment Instrument
. - Handle any onboarding rejections.
- Upload files as needed to appeal any onboarding rejections.
Onboarding with the Finix API
Onboarding with the Finix API means your platform handles every aspect of onboarding sellers.
-
Create an
Identity
for your seller. -
Create associated
Identities
as needed for additional owners or control persons. - Tokenize the seller's bank account
-
Onboard the seller by creating a
Merchant
. - Handle any onboarding rejections.
- Upload files as needed to appeal any onboarding rejections.
Process Payments
Any platform that goes live needs to be able to process payments.
Depending on the payment methods you want to accept, your platform will need to handle these different flows:
Additionally, all platforms need to handle the following:
Card Payments
Your platform needs to handle the following to process transactions where the buyer pays with a card:
-
Create an
Identity
for the buyer. - Tokenize the buyer's card details using our Tokenization Forms.
-
Process the payment by
creating a
Transfer
.-
Alternatively,
create and capture an
Authorization
.
-
Alternatively,
create and capture an
-
Handle payments that fail and their related
failure_code
.
Raw Card Payments
If you're fully PCI DSS compliant and want to handle raw card data:
Apple Pay Payments
To support Apple Pay, your platform needs to process an Apple Pay transaction with either:
Google Pay Payments
To support Google Pay, your platform needs to process a Google Pay transaction with either:
ACH (eCheck) Payments
Successfully process an ACH (eCheck) Payment where the buyer pays with their bank account details.
Payout and Fee Collection
Your platform needs to be able to payout sellers and collect fees:
-
Understand how
Settlements
and payouts work in Finix. -
Display the history of
Settlements
and payouts to sellers.
Technical Considerations
A complete technical integration includes the following:
- Set up Webhooks to receive updates about changes in your payment activity.