FinAxis

FinAxis is a leading provider of specialized payment gateways for high-risk businesses.

Supports in this guide: Payments, Payouts

Provider website: finaxis.cloud

What you need to do for start processing transactions (brief summary)

Get your credentials (from FinAxis)
Connect in Dashboard
Send an API request

Prerequisites: get from FinAxis

Contact your FinAxis account manager to get your account verified and receive the following credentials.

API key -> Corefy field api_key.
Secret key -> Corefy field secret_key -> used to sign requests and verify callbacks.
API URL (optional) -> Corefy field api_url -> leave empty to use the default production URL (https://api.finaxis.vip); fill in only if FinAxis shared a custom endpoint.
Currency -> Corefy field currency -> one of ARS, AUD, INR, NPR.

Important

The account currency is fixed per connection and cannot be changed afterward. Create a separate Provider account connection for each currency you need to process.

One Provider account is used for both Payments and Payouts.

Payments processing (connect Provider account, create payment-invoice)

Connect Provider account in Corefy Dashboard

Step 1 - Open connection form

Open FinAxis in the provider directory and press Connect at FinAxis Provider Overview page in the New connection section.

Step 2 - Fill in fields and select settings

API key
Secret key
API URL (optional)
Currency

Success

You have connected FinAxis Provider account!

First request to Corefy API (MIN)

What it does: creates a payment-invoice using the display-requisites invoice flow - FinAxis returns bank/wallet requisites, and the customer transfers funds to them directly (no redirect or card data involved).

Pay-in services per currency

Currency	Service
ARS	`bank_transfer_ars_invoice`
AUD	`pay_id_aud_invoice`
INR	`upi_inr_invoice`
NPR	`esewa_npr_invoice`

Payment - MIN

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "85af8385-d00e-4f58-ab1f-3a527fdf2d3b",
      "service": "bank_transfer_ars_invoice",
      "currency": "ARS",
      "amount": 1000,
      "customer": {
        "reference_id": "85af8385-d00e-4f58-ab1f-3a527fdf2d3b"
      }
    }
  }
}

Important

customer.reference_id is required - it's forwarded to FinAxis as the client ID.

Payment - MAX

POST /api/payment-invoices

{
  "data": {
    "type": "payment-invoice",
    "attributes": {
      "reference_id": "1f2aa3ca-abd8-4741-980d-4017ed30cb8c",
      "service": "bank_transfer_ars_invoice",
      "currency": "ARS",
      "amount": 1000,
      "customer": {
        "reference_id": "85af8385-d00e-4f58-ab1f-3a527fdf2d3b",
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "+2134234234523",
        "address": {
          "full_address": "123 Baker street",
          "country": "AR",
          "city": "Buenos Aires",
          "post_code": "1000"
        }
      }
    }
  }
}

Important

For INR and NPR specifically, the customer must confirm the transfer after paying - they submit the payment reference (and, for NPR, sender details) which Corefy forwards to FinAxis via an update step on the same payment. This happens as part of the Corefy checkout flow; no separate API call is needed from your side.

Confirmation fields per currency:

INR -> last_n_digits (12-digit UTR / transaction reference)
NPR -> sender_name, sender_wallet, last_n_digits (7-character transaction ID)

ARS and AUD do not require this confirmation step.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Refunds

FinAxis does not support refunds.

Payouts processing (connect Provider account, create payout-invoice)

Connect Provider account in Corefy Dashboard

Uses the same Provider account connected above - no separate connection step.

First request to Corefy API (MIN)

What it does: creates a payout-invoice. The recipient fields required in fields differ per currency.

Payout services and recipient fields per currency

Currency	Service	Recipient fields (`fields`)
ARS	`bank_transfer_ars`	`bank_account`
AUD	`bank_transfer_aud`	one of `bank_account` / `beneficiary_phone`, plus `bank_branch`, `beneficiary_email`
INR	`bank_transfer_inr`	`account_number`, `beneficiary_name`, `ifsc`
NPR	`bank_transfer_npr`	`account_number`, `beneficiary_name`

Payout - MIN (ARS)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "6f7a8b9c-0d1e-4f20-8b13-6c7d8e9f0a1b",
      "service": "bank_transfer_ars",
      "currency": "ARS",
      "amount": 1000,
      "fields": {
        "bank_account": "0000003100010000000001"
      }
    }
  }
}

Payout - MAX (INR)

POST /api/payout-invoices

{
  "data": {
    "type": "payout-invoice",
    "attributes": {
      "reference_id": "7a8b9c0d-1e2f-4031-8c24-7d8e9f0a1b2c",
      "service": "bank_transfer_inr",
      "currency": "INR",
      "amount": 500,
      "fields": {
        "account_number": "1234567890",
        "beneficiary_name": "Rahul Sharma",
        "ifsc": "HDFC0001234"
      }
    }
  }
}

Important

For AUD, pass only one of fields.bank_account or fields.beneficiary_phone (whichever applies), plus fields.bank_branch and fields.beneficiary_email.

Extended request (MAX)

Why add extra fields (typical reasons): - Provide additional customer details for compliance/reconciliation - Positively influence conversion rate - Include optional fields required by your specific flow

Additional info

Active reconciliation is available - both Payments and Payouts support an active status request in addition to the asynchronous callback.
No recurring - this connector does not support saving/charging a token through Corefy.
No Options or Constants are configured for this connector.

FAQ / Troubleshooting

Invalid credentials / auth error -> verify the API key, secret key, and API URL (if a custom one is used)
Payment stuck pending for INR/NPR -> the customer needs to confirm the transfer with the payment reference (UTR/transaction ID) before it finalizes
Need to process more than one currency -> create a separate FinAxis Provider account connection per currency - the account currency is fixed at connection time
Payout rejected for missing fields -> check the recipient fields required for the specific currency/service you're using
Refund fails -> FinAxis does not support refunds through Corefy

Question

Still looking for help connecting your FinAxis account? Please contact our support team!