Skip to main content

Search

Admoji Help Center

Browse guides, FAQs, and tutorials — or search for something specific

How to Set Up the Finix Payment Gateway

Finix is a payment facilitation platform. This guide covers the credentials Admoji needs to connect a Finix merchant account and the settings that are specific to this gateway.

Note: Collect four values from your Finix dashboard before you start: Username, Password, your Merchant Identity ID, and the signing secret of the Finix webhook you create in Step 1.

Step 1: Create the Webhook in Finix

Finix tells Admoji when a payment, refund or subscription changes state through a webhook. Admoji does not create this webhook when you add the processor, so set it up in your Finix account first:

  1. In your Finix account, create a webhook that points to https://openapi.admoji.com/api/v1/open/webhooks/finix.

  2. Copy the webhook's signing secret. You paste it into the Application ID field in Step 3.

Important: Without this webhook, or with a signing secret that does not match it, Admoji rejects the events Finix sends. Payments that Finix returns as pending stay pending in Admoji, and refund and subscription updates never arrive.

Step 2: Create the Processor

  1. Go to Merchants > Processors.

  2. Select the Credit Card tab and click New.

  3. On the General tab, choose Finix from the Gateway dropdown.

  4. Click the edit icon next to the gateway to open the credentials drawer.

Add New Processor General tab with Finix selected in the Gateway field and the edit icon beside it

Step 3: Enter the Finix Credentials

The drawer shows four credential fields and two toggles. All four credential fields are required.

  • Username — your Finix API username.

  • Password — your Finix API password.

  • Merchant Identity ID — the Finix identity that owns the merchant account.

  • Application ID — the signing secret of your Finix webhook. The label does not match what the field holds: Admoji stores this value as the secret it uses to check the signature on every event Finix sends back.

  • Test Mode — turn on to point the processor at your Finix sandbox instead of production.

  • Live Test Mode — this toggle is shown for every gateway, but Finix ignores it. Only Test Mode decides whether the processor talks to the sandbox or to production.

  1. Fill in all four credential fields.

  2. Click Validate. Admoji looks up your Merchant Identity in Finix and, on success, shows Credentials successfully validated, closes the drawer and displays the gateway as a badge on the General tab.

Finix credentials drawer with Username, Password, Merchant Identity ID and Application ID, the Test Mode and Live Test Mode toggles, and the Validate button
Important: Finix credentials have to be validated before the processor can be saved. If you close the drawer without a successful validation, Admoji warns Please validate the gateway credentials, and clicking Save reopens the drawer instead of saving. Editing any credential field after validating clears the validation, so validate again before you save.
Note: With Test Mode on, Validate does not call Finix — the check is simulated inside Admoji and always succeeds. Turn Test Mode off and validate again when you want to confirm that the live credentials really work.

Step 4: Complete the Processor Settings

  1. Enter a Processor Name on the General tab.

  2. Open the Settings tab and enter the MID Number and Currency — both are required.

  3. Under Transaction Mode, choose Default (Sale) or Auth + Capture. Finix supports both.

  4. If you select Auth + Capture, optionally set Capture Delay (Days). Leave it empty to capture manually.

  5. Click Save.

Settings tab with MID Number and Currency filled in and Transaction Mode set to Auth + Capture, which reveals the Capture Delay (Days) field
Tip: Finix is one of the gateways that supports the split authorization and capture flow. See How to Set Up Auth + Capture for how the schedule works and where to track authorized transactions.

Related articles