Docs

MAXFI Developer Hub

MAXFI accepts payments for your business through one API: a payment page hosted by MAXFI, the Widget SDK that opens this page on your site, refunds, and webhooks about payment status. Payments are accepted in AZN, USD, EUR and RUB. The same API sends payouts to a recipient’s bank card, in AZN.

MAXFI is operated by M.A.X SİSTEMLƏRİ PLYUS LLC (Max Systems), a payment institution licensed by the Central Bank of Azerbaijan.

Quickstart

Create a test payment page, pay with a test card and receive the payment.succeeded webhook.

Hosted payment page

POST /v2/payments/checkout returns a link to the MAXFI payment page. Card details are entered there, not on your site.

Widget SDK

Opens the payment page in a window on your site. Your server creates the session; the page uses only the publishable key.

Payment methods

Card, Apple Pay, Google Pay, SBP, SberPay, T-Pay and YooMoney on the payment page, saved cards through the API: how the list for each payment is built.

Webhooks

Payment and payout status events with up to 8 delivery attempts, signed with HMAC-SHA256 when a webhook secret is set.

Refunds

Return money for a payment with POST /v2/payments/{id}/refund.

Card payouts

POST /v2/payouts creates a payout with a link for the recipient, who enters the card on a MAXFI page.

How it works

Your server creates a payment session with a secret key: POST /v2/payments/checkout. The response contains checkout_url.
You send the customer to checkout_url. The customer pays on the MAXFI payment page with a method enabled for your account. When the card issuer requires 3-D Secure, the payment page takes care of it.
MAXFI sends the result to your webhook URL. After a successful payment, the page shows the customer a button back to your success_url.

Test and live mode

Test keys (sk_test_, pk_test_) never reach a bank: payments are simulated, test cards always behave the same way, and responses and webhooks carry "livemode": false.

Live keys (sk_live_, pk_live_) work after MAXFI enables live mode for your account, once onboarding and KYC are complete. There is no self-service sign-up: send an application on the access request page. After onboarding, you create keys in the merchant portal.

Questions about the integration: contact us.