YooKassa Integration
Accept payments in Russia and beyond — via YooKassa. GulliverCRM supports integration with YooKassa via OAuth: you log in to your YooKassa account once, and the CRM obtains and refreshes the required tokens automatically. This page will help you set up acquiring via OAuth step by step.
1. Connecting a YooKassa Account
To start working with acquiring, you will need a merchant account in YooKassa. If you don’t have one yet, sign up on the official website. Once connected (this may take some time), you will get access to your YooKassa dashboard.
2. Authorization via OAuth in GulliverCRM
In GulliverCRM, go to the system settings and open Application → Integrations → Add integration. Select YooKassa from the provider list.
In the form that opens, click Connect YooKassa, log in to your YooKassa account, and confirm granting access to the application.
That’s it.
3. Setting Up Notifications (Webhooks)
There’s nothing to configure here either — everything has already been done for you. After the integration is connected, GulliverCRM subscribes to all required events in YooKassa automatically:
- successful payment;
- canceled payment;
- payment awaiting confirmation (for two-stage payments).
As soon as a customer pays an invoice, the CRM is notified instantly and updates the data. You don’t need to log in to your YooKassa dashboard, specify anything, or check anything — the system does everything automatically.
Important: make sure your YooKassa account is active and the GulliverCRM application has valid access. If the OAuth token has expired or been revoked, GulliverCRM will detect this automatically and notify you — reauthorization will be required.
P.S.
- All interactions with the service within the integration occur without user involvement. When an invoice is issued in GulliverCRM, it automatically appears in YooKassa. Once payment is received via YooKassa, it automatically appears in the corresponding billing section.
- Since all payments in YooKassa are made based on issued invoices, invoices are closed automatically at the same time as payment — without manual intervention.
- GulliverCRM monitors the OAuth token status: if access expires or is revoked, the system will notify you in time so that payment acceptance does not stop.
- Our system makes every effort to ensure documents in the CRM and YooKassa match, so it periodically performs reconciliations and rechecks data behind the scenes.
- Acquiring service fees are paid separately under a bilateral agreement between your company and YooKassa.
