تخطَّ إلى المحتوى

Payment & Cash Register Providers in IZI

Опубликовано: · Обновлено: (6 дней назад)· IZI Team

هذا المحتوى غير متوفر بلغتك بعد.

Providers in IZI are organization-level integrations with payment systems and fiscal receipt services. Configure them once and every club in your network can share the same connections. The section lives at Money → Payment methods → Providers and covers two distinct types: payment providers (accepting money from clients) and cash register providers (generating fiscal receipts for regulatory compliance). Both types appear in a single table with columns for Name, Type, Usage, Status, and Last Updated. A provider is either Active (credentials entered and verified) or Not configured (created but keys not yet filled in or invalid).

The separation between the two types matters because they serve different purposes and involve different external services. A payment provider connects IZI to an acquiring bank or payment gateway — the service that actually moves money from the client’s card or wallet into your account (see client payments). A cash register provider connects IZI to a fiscal receipt service — the system that generates legally compliant receipts and reports transactions to the relevant tax authority. Many clubs need both: the payment provider to charge clients, and the cash register provider to satisfy local tax law. Clubs that accept only cash and operate in markets without mandatory fiscal receipts may only need one or neither.

To add a provider, click the button in the top-right corner of the page, choose the integration type, and follow the form for that specific provider. Once created at the organization level, each provider is assigned to individual club cash registers inside their own settings. Providers cannot be created at the club level — the organization scope is intentional and ensures credential management stays centralized.


A payment provider is your acquirer: the service through which a client pays by card, Apple Pay, or QR code. IZI supports several providers, each with its own payment methods and market.

ProviderCardApple PaySBP (QR)Typical region
CloudPaymentsYesNoYesRussia
StripeYesYesNoInternational
HyperPayYesYes + MadaNoMiddle East (UAE, Saudi Arabia)
MethodPay (Paygine)YesNoNoRussia (not offered in the add form)
MonetaYesNoYesOrganizations from Russia only
FlittYesNoNoOrganizations from Georgia only (GEL)
bePaidYesNoNoOrganizations from Belarus only (BYN)

Moneta, Flitt and bePaid are tied to the organization’s country: they appear in the provider list only when the organization’s country matches.

  1. Go to Money → Payment methods → Providers and click Add.
  2. In the dialog, set Integration Type to Payment Provider.
  3. Enter a Name for this integration (e.g., “Stripe Main” or “CloudPayments RU”).
  4. Select the Provider from the dropdown.
  5. Fill in the provider credentials (see sections below).
  6. Click Save. The system generates a Webhook URL — copy it and add it in your provider’s dashboard.

The form shows a CloudPayments Settings block:

  • Public ID — the public store identifier from your CloudPayments dashboard.
  • API Secret — the secret key used to sign requests.

After saving, copy the Webhook URL and paste it into the notification settings in your CloudPayments account.

The form shows a Stripe Settings block:

  • Publishable Key — your public key (pk_live_...).
  • Secret Key — your secret key (sk_live_...).
  • Webhook Secret — the signing secret for webhook verification. Must start with whsec_ (find it in Stripe Dashboard → Webhooks, not in the API keys section).

Optionally, the Apple Pay Settings block:

  • Toggle Enable Apple Pay on.
  • Enter the Merchant ID from Apple Developer (must start with merchant.).

The form shows a HyperPay Settings block:

  • Access Token — your HyperPay API access token.
  • Entity ID — the merchant entity identifier.
  • Webhook Secret — a 64-character hex string (AES-256 key for webhook verification).
  • API URL — the HyperPay API endpoint for your region.

Optionally, an Apple Pay Settings block (same structure as Stripe, with additional support for the Mada network in Saudi Arabia).

Moneta is configured with a single field:

  • Account key — 32 characters from the Moneta personal account. A “Where to get the account key” hint sits under the field: open the Moneta account, choose Accounts in the Data block on the left, click Data at the top right → Requisites, open the entry with your account and copy the value from the last row, Account key. It is not a BIC or a bank account number; you do not need to enter the organization name, tax ID or other details.

Players pay through Moneta by card and by SBP.

Flitt (formerly Fondy) accepts cards in Georgian lari (GEL) only. The form has two fields: Merchant ID and Secret Key from your Flitt account. A player can link a card, after which payments are taken from the linked card automatically; refunds are supported.

bePaid accepts cards in Belarusian rubles (BYN) only. The form has three fields: Shop ID, Secret Key and Public Key from your bePaid account, plus a Test mode switch for checking without real money. A player can link a card for automatic charges; e-wallets cannot be linked.

The form shows a MethodPay Settings block with fields provided by your MethodPay/Paygine account manager. This provider supports card payments only — Apple Pay and SBP are not available.


A cash register provider generates and transmits fiscal receipts. IZI supports two adapters, each covering a specific regional compliance model.

AdapterSupported countriesKey features
PrinterUAE (AE), Morocco (MA), Saudi Arabia (SA), Oman (OM), Bahrain (BH), Kuwait (KW), Qatar (QA)VAT toggle at the country rate, TRN when VAT is enabled, legal entity name required, CR number optional
KKMRussia (RU)Tax regime required per operation category
  1. Click Add → select Cash Register Provider.
  2. Enter a Name for the integration.
  3. Choose an Adapter (Printer or KKM).
  4. Set the Country.
  5. Fill in the Cashier field — the name or identifier that appears on receipts.
  6. Configure Tax Settings (vary by adapter, see below).
  7. Click Save.

Tax settings — Printer (Middle East and Morocco)

Section titled “Tax settings — Printer (Middle East and Morocco)”
  • VAT — toggle. When enabled, the club country’s rate is applied to receipts: UAE 5%, Morocco 20%, Saudi Arabia 15%, Oman 5%, Bahrain 10%. Kuwait and Qatar have no VAT, but the register works.
  • TRN (Tax Registration Number) — your VAT registration number. Required when VAT is enabled. Must not exceed the allowed character length.
  • Legal entity — the company name printed on receipts. Required for the Printer adapter.
  • CR number (company registration number) — the commercial registration number of the legal entity. Optional: when filled in, it is printed in the receipt header. Relevant for clubs in Oman and other Gulf countries where the CR number is a mandatory field on fiscal documents.

For the KKM adapter, specify a tax regime separately for three operation categories:

CategoryWhat it coversWhen a receipt is issued
Balance top-upClient deposits funds — credited as a prepaymentAt the moment of top-up
ServicesPurchase of gaming tariffs and session timeWhen a tariff is purchased
GoodsPurchase of bar items and merchandiseWhen a product is purchased

IZI supports all current Russian tax regimes: PSN (patent), USN (revenue), USN (revenue minus expenses), AUSN (revenue) 8%, AUSN (revenue minus expenses) 20%, OSNO with various VAT rates (0%, 10%, 20%, 22%, and calculated rates), as well as reduced regional USN rates of 5% and 7%.

A provider starts working in a club once it is selected in that club’s payment settings: organization section Money → Payment methods → Payments. The table shows, per club, the card and Apple Pay providers, postpay, the cashbox and tax regimes. Click a club row to open Payment settings for …:

FieldWhat to choose
CardThe payment provider for card payments
Apple PayThe provider for Apple Pay
SBPThe provider for SBP payments
CashboxThe club’s cashbox provider
Print order slip by defaultThe order slip prints without an extra cashier action

SBP only — the club’s clients can link payments only via SBP, which removes card fees. The toggle appears under the SBP field when a card provider is selected and the club has SBP payments: through CloudPayments or through Moneta selected separately in the SBP field.

When turning it on, CRM asks what to do with cards already linked: Keep or Unlink all — the latter unlinks this provider’s cards in every club where it is used. If you later clear the SBP field, CRM warns on saving that SBP only mode will turn off and clients will be able to link cards again.


All created providers appear in a single table. Click any row to open the edit form. The Usage column shows how many cash registers each provider is linked to — this helps you assess the impact before making changes.

Credentials can be updated at any time — for example, after a key rotation. After saving, the provider continues working without interruption. If you update the Webhook Secret or Webhook URL, remember to update it on the provider’s side as well.

Deleting a provider is irreversible. Before deleting, confirm it is not linked to any club cash register — otherwise those registers lose their connection to the acquirer or fiscal system. The number of linked registers is shown in the Usage column.

When a payment provider is deleted, CRM states how many clubs it will be removed from: payment methods through it are switched off there, and all player cards linked to it are unlinked. Changing a club’s provider works the same way: CRM asks for confirmation before saving, after which the club’s players have to link their cards again (see Payment Methods).


Do I need to configure both provider types?

It depends on your market requirements. A payment provider is needed if clients pay by card through a terminal or the mobile app. A cash register provider is needed if local law requires fiscal receipts — as in Russia (54-FZ) or UAE (VAT). Clubs that operate exclusively with cash and have no fiscal compliance requirement may skip the cash register provider.

Can one payment provider serve multiple clubs?

Yes. A provider is created once at the organization level and then linked to cash registers in any number of clubs in your network. This lets you manage API keys in a single place rather than per club.

How does IZI use the Webhook URL?

After you create a payment provider, IZI automatically generates a unique Webhook URL. The payment system sends transaction status notifications (success, decline, refund) to this address. Without a correctly configured webhook, IZI will not receive real-time payment confirmations.

What should I do if a provider still shows “Not configured” after saving?

Check that all credentials are correct. Common mistakes: for Stripe, the Webhook Secret is an API key instead of the signing secret (must start with whsec_); for HyperPay, the Webhook Secret is not a 64-character hex string; for Apple Pay in Stripe or HyperPay, the Merchant ID does not start with merchant..

الأسئلة الشائعة

Which payment systems does IZI support?

Under Money → Payment methods → Providers you can connect CloudPayments (cards + SBP, Russia), Moneta (cards + SBP, organizations from Russia only), Stripe (cards + Apple Pay, international), HyperPay (cards + Apple Pay + Mada, Middle East), Flitt (cards in lari, organizations from Georgia only) and bePaid (cards in Belarusian rubles, organizations from Belarus only). Each provider is connected separately.

Where do I get the Moneta account key?

In your Moneta personal account: in the Data block on the left open Accounts, click Data at the top right and choose Requisites, open the entry with your account and copy the value from the last row, Account key. It is 32 characters long. It is not a BIC or a bank account number.

What happens to players' cards if the payment provider is changed or deleted?

Cards linked to the old provider are unlinked and players have to link them again. CRM asks for confirmation before a change, and when a provider is deleted it states the number of clubs where it is used.

What is the difference between a payment provider and a cash register provider?

A payment provider handles money collection from the client — card acquiring, QR codes, Apple Pay. A cash register provider handles generating and submitting fiscal receipts to the tax authority. These are two independent integration types that can be used together or separately.

Can I connect multiple payment providers at the same time?

Yes. You can register multiple payment providers within a single organization. Each provider is then assigned to specific club cash registers in the cash register settings.

How do I connect CloudPayments to IZI?

Go to Money → Payment methods → Providers, click Add, choose Integration Type → Payment Provider, then select CloudPayments. Enter the Public ID and API Secret from your CloudPayments dashboard. After saving, copy the generated Webhook URL and add it to your CloudPayments notification settings.

How do I set up Stripe with Apple Pay?

Create a Stripe payment provider and enter the Publishable Key, Secret Key, and Webhook Secret (must start with whsec_). In the Apple Pay Settings block, enable Apple Pay and enter the Merchant ID from Apple Developer (must start with merchant.). The same Apple Pay option is available for HyperPay.

Which cash register adapters does IZI support?

IZI supports two adapters: Printer (for the UAE, Morocco, Saudi Arabia, Oman, Bahrain, Kuwait and Qatar — supports VAT at the country rate and TRN) and KKM (Russia only — requires a tax regime per operation category, supports USN, OSNO, AUSN, and PSN).

What is TRN and when is it required?

TRN (Tax Registration Number) is the VAT payer identification number. In IZI it is required when you enable VAT (5% rate) in a Printer-type cash register provider for UAE. If VAT is disabled, TRN is not mandatory. The Printer adapter also supports a CR number field (company registration number) — it is optional and is used by clubs in Oman and other Gulf countries where the CR number must appear in the receipt header.

How do I configure tax regimes for a Russian cash register?

When creating a cash register provider with the KKM adapter (country: Russia), specify a tax regime separately for three operation categories: balance top-up, services (gaming tariffs), and goods (bar and merchandise). IZI supports USN, OSNO, AUSN, PSN, and all current variants including reduced regional rates.

What does the 'Not configured' status mean?

Not configured means the provider was created but its credentials (API keys, tokens) have not been entered or are invalid. Such a provider cannot accept payments or issue receipts. Click the provider row to open the edit form and fill in all required fields.

How do I see how many cash registers are linked to a provider?

The Usage column in the providers table shows the number of cash registers (for a cash register provider) or payments/registers (for a payment provider) that the given provider is linked to.

Can I delete a provider that is currently in use?

Deletion is irreversible. Before deleting, make sure no club cash register is using the provider. After deletion, you cannot restore it — you must recreate it and re-enter all credentials.

Where is the Providers section in IZI?

The section is available at Money → Payment methods → Providers. It is only visible to users with organization management permissions.

About IZI