Skip to content

CloudPayments Mobile App Online Payment Integration

Published: · Updated: (12 days ago)· IZI Team

Connecting CloudPayments to the IZI mobile app lets guests pay for gaming sessions online — without staff intervention. You need access to your CloudPayments merchant account and the Integrations permission in IZI CRM. The setup takes four steps: grab your API keys, register the provider in CRM, point CloudPayments webhooks at IZI, then assign the provider to each club.

Step 1. Get your API keys from CloudPayments

Section titled “Step 1. Get your API keys from CloudPayments”
  1. Log in to your CloudPayments merchant dashboard.
  2. Navigate to Sites and select the site that matches your organization name.
  3. Copy and save two values:
    • Public ID
    • API password — click the show button to reveal it.

Keep these values on hand; you will paste them into IZI CRM in the next step.

Step 2. Add the payment provider in IZI CRM

Section titled “Step 2. Add the payment provider in IZI CRM”
  1. Open IZI CRM and select your organization.
  2. In the left sidebar go to IntegrationsIntegrations tab.
  3. Click Add.
  4. Set Integration type to Payment provider.
  5. Fill in the form:
    • Name — a label you will recognize later, for example “CloudPayments”.
    • Provider — select CloudPayments from the list.
    • Public ID — paste the value from your CloudPayments dashboard.
    • API Secret — paste the API password.
  6. Click Save.
  7. Open the integration you just created and click Copy next to Webhook URL. Then click Cancel to exit without changes.

The webhook URL is the address IZI listens on for payment status updates. You will paste it into CloudPayments in the next step.

Step 3. Configure webhooks in CloudPayments

Section titled “Step 3. Configure webhooks in CloudPayments”
  1. Return to your CloudPayments dashboard → Sites → select your site.
  2. Open the Notifications tab.
  3. Enable notifications and paste the copied Webhook URL into each of the following fields:
    • Pay — successful payment received.
    • Fail — payment declined.
    • Confirm — payment confirmed.
    • Refund — payment refunded.
    • SbpToken — SBP account binding result (if you use SBP).
    • Kkt — cash register status change.
  4. Click Save notifications.

This wires CloudPayments real-time status updates back to IZI, so session balances and receipts update automatically without polling.

The integration lives at the organization level, but payment routing is configured per club. Repeat the following for every location where guests should be able to pay via CloudPayments:

  1. In IZI CRM open IntegrationsPayments tab.
  2. Click the row for the club you want to configure.
  3. In the Cards field select the CloudPayments provider you created.
  4. Click Save.

Once assigned, the IZI mobile app will offer CloudPayments as a payment method at checkout for that club.

Frequently asked questions

What permissions do I need to connect CloudPayments in IZI CRM?

You need the Integrations permission in the CRM for the relevant organization, plus admin access to your CloudPayments merchant account.

Where do I find the Public ID and API Secret in CloudPayments?

Log in to your CloudPayments merchant dashboard, go to Sites, select your site, and copy the Public ID. Click the show button next to the API password to reveal your API Secret.

Do I need to configure SSL or client certificates for the webhook?

No. Leave SSL, client certificate, and basic authorization settings at their defaults — IZI handles the secure connection on its end.

Can one CloudPayments integration serve multiple clubs in the network?

Yes. You create the integration once at the organization level, then assign the same provider to as many clubs as needed from the Payments tab.