Integration Checklist
Use this checklist to make sure a smooth transition happens when taking your Finix integration live.
An integration checklist is a list of the key aspects of an integration. Completing the checklist ensures your implementation is complete and you will successfully run a payment platform.
The checklist has the following key categories:
We perform a certification for your sandbox and live environment. The certification process uses the integration checklist but is structured by scenarios.
Account and Login
-
Understand Finix's account structure and have your Application's
id
. - You need access to the Finix Dashboard.
Onboarding
You need to be able to handle Onboarding the sellers and service providers you sign up onto Finix, including failure flows and Onboarding Rejections:
- Understand the Seller Onboarding Process
- Depending on your onboarding integration, you need to follow:
Onboarding Forms
Onboarding Forms manages the initial creation of resources. Your integration needs to be able to handle onboarding rejections.
-
Create an
Onboarding Form
. - Redirect users to link.
-
Retrieve the created
Identity
,Merchant
,Payment Instrument
. - Handle onboarding rejections.
Onboarding With the API
Onboarding with the API means your integration has to handle all aspects of onboarding.
-
Create an
Identity
for you seller. -
Create associated
Identity
for additional owners or control persons. - Tokenize the seller's bank account
-
Verify seller by creating a
Merchant
. - Handle onboarding rejections.
Process Payments
Any integration needs to be able to make payments.
Depending on your payment methods you want to support, your integration needs to handle different flows:
All integrations need to handle:
Card payments
-
Create an
Identity
for a buyer. - Tokenize card details with Hosted Tokenization.
-
Make a payment by
creating a
Transfer
.- Alternatively, make a separate authorization and capture.
-
Handle failed payments and their
failure_codes
.
Raw card payments
If you're fully PCI DSS compliant and want to handle raw card data:
Apple Pay Payments
- Successfully perform an Apple Pay Payment with either:
Google Pay Payments
- Successfully perform a Google Pay Payment with either:
ACH (eCheck) Payments
- Successfully perform an ACH (eCheck) Payment.
Payout and Fee Collection
You need to be able to payout your sellers and collect fees:
-
Understand how
Settlements
and payouts work in Finix. - Display the history of settlement and payouts to sellers.
Technical Considerations
A complete technical integration includes the following: