Integration Certification

Review the requirements Finix has in place before businesses can process live transactions.


This article details the scenarios and requirements integrations need to perform to receive certification from Finix to process live transactions.

Before reviewing our certification requirements, verify that your integration passes our Integration Checklist. Finix requires integrations to pass specific scenarios to ensure your implementation is accurate and successful.

info

These certification scenarios are only for Finix for Businesses. All other experiences integrate with Finix as a platform to go live. See Platform Certification for details on how to integrate your platform with Finix.

Sandbox vs. Live Certification

Passing sandbox certification is required to gain access to a live environment.

Sandbox certification involves integrating with the sandbox environment provided and processing test payments per Finix's requirements.

Process Payments

There are several payment scenarios your integration should handle.

Process a Card Payment

  • Create an Identity for a buyer using your checkout page.
  • Tokenize the buyer's card details using our Tokenization Forms.
  • Create a Payment Instrument for the buyer.
  • Create a payment using a Transfer .

For details on how to do the above, see Card Payments in Integration Checklist.

Process a Transfer with Fraud

  • Create an Identity for a buyer using your checkout page.
  • Tokenize the buyer's card details using our Tokenization Forms.
  • Create a Payment Instrument using the token.
  • Process a payment greater than $200, using a Transfer .
    • The transaction should get declined. Finix has a rule setup in sandbox environments to decline transactions equal to $1.37 or greater than $200)

For details on how to do the above, see:

Process an Authorization

  • Create an Identity for a buyer using your checkout page.
  • Tokenize card data using our Hosted Tokenization Fields.
  • Create a Payment Instrument using the token.
  • Create a payment using an Authorization .
  • Capture the Authorization .

For details on how to do the above, see:

Process an Authorization with Fraud

  • Create an Identity for a buyer using your checkout page.
  • Tokenize card data using Hosted Tokenization.
  • Create a Payment Instrument using the token.
  • Create a payment using an Authorization followed by a Transfer .
    • The transaction should get declined. Finix has a rule setup in sandbox environments to decline transactions equal to $1.37 or greater than $200)

For details on how to do the above, see:

Process an ACH (eCheck) Transaction

  • Create an Identity for a buyer using your checkout page.
  • Create a Payment Instrument using the bank account details.
  • Create a Transfer with the Payment Instrument .

For details on how to do the above, see ACH (eCheck) Payments in Integration Checklist.

Refund a Payment

  • Create a reversal Transfer .
    • You will need to use the Transfer that was first created during certification.

For details on how to do the above, see Refunding Payments.