Cookbook
Cookbook
Short answers to common integration tasks, each with a link to the page that describes it in detail.
Accept a first test payment
Create a payment session with a test key and pay it with a test card.
Quickstart
Send the customer to the payment page
POST /v2/payments/checkout returns checkout_url; redirect the customer there.
Payment page API
Open the payment page on your site
Load maxfi.js with your publishable key and open the session that your server created.
Widget SDK
Refund part of a payment
Pass amount in minor units and an idempotency_key, so that a retried request does not refund twice.
Refund API
Cancel an authorisation
POST /v2/payments/{id}/void cancels a payment that is authorised and waiting for capture.
API reference
Handle webhooks safely
Verify X-MAXFI-Signature, answer with 2xx within 10 seconds and use X-MAXFI-Event-Id to skip repeated deliveries.
Webhooks
Offer SBP, SberPay and wallets
Which payment methods exist and how they are enabled for your account.
Payment methods
Separate traffic sources
Pass channel_id to keep a website, a bot and an app apart under one account.
Channels
Need an example for a case that is not covered here?
Ask us