Integration guides

A MAXFI integration usually goes through these steps. Each step links to the page that describes it.

1. 1
   Get access

   Send an application. After onboarding and approval you create test keys in the merchant portal.

   Request access
2. 2
   Make a test payment

   Create a payment session with a test key and pay it with a test card.

   Quickstart
3. 3
   Choose how the customer pays

   Redirect the customer to the MAXFI payment page (POST /v2/payments/checkout), or open the payment page on your site with the Widget SDK.

   Payment page API Widget SDK
4. 4
   Enable payment methods

   Cards, Apple Pay, Google Pay, SBP, SberPay, T-Pay and YooMoney, and how each of them is enabled for your account.

   Payment methods
5. 5
   Handle webhooks

   Receive payment.succeeded and the other events, verify the X-MAXFI-Signature header and answer with 2xx within 10 seconds.

   Webhooks
6. 6
   Refunds

   Full and partial refunds. Pass idempotency_key so that a retried request does not refund twice.

   Refund API
7. 7
   Channels (optional)

   Keep traffic sources such as a website, a bot or an app apart under one account by passing channel_id.

   Channels
8. 8
   Go live

   MAXFI turns on live mode for your account; then you replace your test keys with live keys (sk_live_…).

Questions about your integration? Contact us.