Skip to content

Questions and answers

37

General

What is Bankemes?

Bankemes is an integration service for accepting website or application payments through a seller’s connected cashier. Funds go directly to the seller’s bank account.

Which payment methods are available?

Kaspi Pay through the seller’s cashier. Halyk ePay appears only in the mode enabled for a specific cashier; other banks are not advertised as supported without verified compatibility.

Kaspi

Is Bankemes an official Kaspi partner?

No. Bankemes works with your Kaspi Pay cashier by signing in with the cashier phone number and SMS code, just as you do yourself. This is not the official Kaspi Bank API.

Where does the money go?

To your Kaspi cashier account. Bankemes does not receive or hold buyer funds.

What if Kaspi ends the cashier session?

The dashboard warns you and new payments through that cashier pause until reconnection. Existing payment checks resume after reconnection.

Invoices, setup, and API

What is required to connect a website?

A connected cashier, active subscription, resource (website address), and API token. See the developer section for details.

Do I need a developer?

The Merchant API requires access to the website backend. An AI agent with authorized project access can help; ready-made plugins must still be checked against your configuration.

Can I issue an invoice to a buyer’s phone?

Yes. Create a Kaspi Pay remote invoice in the dashboard or Merchant API. This is a banking operation: verify the phone and amount, then reconcile status through Bankemes.

How do I know an order was paid?

Use the payment.paid webhook or request status through the API. A buyer returning to a thank-you page does not confirm payment.

What is Idempotency-Key?

A creation request key. Repeating a request with the same key returns the same payment instead of creating another.

How does a remote invoice differ from a link?

A Kaspi Pay remote invoice is created by the bank for the buyer’s phone number; a Bankemes link is opened by the buyer. Creating a remote invoice is a real banking operation with no test mode.

Who sends the invoice notification?

Kaspi notifies the buyer if the bank confirms creation of a remote invoice. Bankemes does not send an SMS or WhatsApp link in place of a bank invoice.

Is Halyk available?

The Halyk ePay adapter operates in test mode. Live mode will be enabled only after integration verification with the bank.

MCP and AI agents

How do I connect Bankemes to an AI agent?

Add the Bankemes server through OAuth in a compatible MCP client, or use an authorized setup key. With your permission, the agent can read instructions and configure the resource and integration. Real invoices require separate owner approval.

Should I give the agent a password or SMS code?

No. Kaspi passwords, SMS codes, and sessions are entered only on Bankemes or bank pages. The agent must never receive these secrets.

Can AI configure recurring buyer invoices?

Yes. An MCP agent can help create, pause, resume, or cancel a schedule. Creating a schedule issues real invoices and requires owner approval in the dashboard.

Subscriptions and invoices

Is this a Bankemes subscription or a subscription for my buyers?

A Bankemes subscription is the seller’s fee for using the platform. Buyer invoice schedules can be configured in Bankemes, or subscriptions can be managed in your own application with the Merchant API and webhooks. Buyers pay every invoice themselves.

When does the trial begin?

The 48-hour trial starts when registration and phone verification are completed. It is granted once per phone number and covers only the first cashier. Issuing an API key does not change the trial dates.

How is a Bankemes subscription renewed?

When recurring invoices are enabled, Bankemes sends an invoice to the saved Kaspi phone 24 hours before the paid period ends. The seller pays it manually; there is no automatic debit. A three-day grace period follows expiry.

Integrations

Are ready-made website modules available?

The project repository contains WooCommerce and OpenCart plugins. Verify compatibility with your configuration and test a real payment before publishing.

Can Bankemes connect to a CRM or automation service?

The codebase contains adapters and example workflows. Setup requires credentials and verification of the test flow.

Security and payment verification

When is a payment considered paid?

Only after the bank confirms the status and the amount matches. Ambiguous responses go to manual review and are not counted as paid.

How are secrets stored?

Cashier sessions, webhook secrets, and Halyk credentials are encrypted; API tokens are stored only as hashes.

Does Bankemes see card data?

No. Payment happens in the bank app; Bankemes does not request card details or passwords.

Connection errors

The cashier shows reconnect_required. What should I do?

Open the dashboard and reconnect the cashier manually. Do not send a password or SMS code to an operator or AI agent.

What if the invoice creation result is unknown?

Do not retry automatically. First check operation history in Bankemes and Kaspi because the bank may have created the invoice even if the response was lost.

Subscription questions

Is there a free period?

Yes: 2 days free, then 4,990 ₸ / month. The 48-hour trial starts when registration and phone verification are completed, is granted once per phone number, and covers only the first cashier. The first payment starts a paid calendar month when confirmed by the bank and ends any remaining trial.

Do I pay per account or per cashier?

Per cashier. Every connected Kaspi cashier has a separate subscription and expiry date.

What does a calendar month mean?

The subscription renews monthly on the paid period’s start date, rather than every 30 days. If that date does not exist in the next month, its last day is used; the original renewal day is retained.

What commission does Bankemes charge?

Bankemes charges 0% commission on turnover. You pay a fixed cashier subscription, with no separate fee per payment. Bank fees and paid third-party services follow their own terms.

How do I pay for a subscription?

Save a Kaspi billing phone number and provide consent in the Bankemes dashboard. Bankemes issues an invoice from its cashier, and you confirm and pay it in Kaspi. Access is extended after bank confirmation.

What happens when a subscription expires?

The paid period is followed by three days of grace. New payments through the cashier then pause until payment. Existing payments continue to be checked and their history remains available.

How does the grace period work?

Paid access is followed by three days of grace. If payment is not confirmed, new payments through the cashier are paused while existing payments continue to be checked.

How is the monthly invoice issued?

Saving the Kaspi billing phone and consent sends the first invoice immediately. The next invoice is issued 24 hours before the paid calendar month ends. You pay every invoice manually; there is no automatic debit.

Can I disable future invoices?

Yes. Disable recurring invoices in the dashboard; this applies to all cashiers on the account. Access already paid for remains active until the end of its period, and an invoice already issued is not cancelled automatically.

What if an invoice is not paid?

Access remains available during the three-day grace period. New cashier payments then stop. Check the invoice status in the dashboard; reconcile an unknown status without creating a duplicate.

Is there a monthly payment quota?

There is no monthly payment count quota. The subscription includes available features: checkout, QR, remote invoices, links, recurring and bulk invoices, customers, API, SDKs, webhooks, MCP, reports, and integrations. Technical rate limits, abuse protection, and bank limits still apply.