Definition
Kaspi Pay for business is a set of Kaspi.kz tools for accepting electronic payments: card acquiring, QR payments, payments via Kaspi.kz and the mobile app, as well as APIs for integration with your website and accounting systems.
How Kaspi Pay works: process from payment to funds receipt
The payment flow for a seller using Kaspi Pay consists of several clear stages:
- Initiation: the buyer selects Kaspi Pay at checkout on the site or scans a QR code at an offline point of sale.
- Authorization: the payment is authorized via Kaspi means (card or Kaspi wallet); funds and risk filters are checked.
- Confirmation: the buyer confirms the payment in the app or via their bank card.
- Clearing: the payment passes through Kaspi's acquiring system; payment details are available to the seller through the merchant dashboard and API.
- Payout: funds are transferred to the seller's settlement account or to an internal Kaspi account according to the payout schedule.
Key parameters sellers focus on: transaction fee, limits, payout speed, and possibilities for automatic reconciliation via API. A test environment and production API are available for integration.
Why Kaspi Pay is useful for a seller: concrete benefits
- Higher checkout conversion. On Kaspi.kz and in the mobile app the share of completed purchases is higher compared to redirecting to third‑party gateways — especially important for items with an average check of 10 000–60 000 KZT. The familiar Kaspi interface reduces abandoned carts.
- Instant clearing inside the ecosystem. Payments to the Kaspi wallet are processed instantly: when a buyer pays from a Kaspi wallet the seller receives an "paid" status immediately, which speeds up shipping.
- Variety of payment methods. Support for cards from any Kazakh banks, Kaspi QR, Kaspi transfers and in‑app payments. This is especially important for retail and FBS sellers who process many small orders.
- Reduced responsibility for disputed transactions. Kaspi provides built‑in dispute and chargeback mechanisms within its ecosystem, simplifying refunds and shortening dispute resolution time.
- Accounting automation. Via API you can automatically pull payment statuses, reconcile receipts and prepare reports without manual entry.
Examples on Kaspi.kz: real seller scenarios in Kazakhstan
Common scenarios where Kaspi Pay is used effectively:
- Online retail: large and medium shops integrate Kaspi Pay to keep conversion high on product pages and during checkout.
- Marketplace sellers: FBS and other marketplace merchants use Kaspi Pay to accept many small payments quickly and reconcile them with orders.
- Offline points: cafes, salons and stores use Kaspi QR or POS integrations to accept quick payments without cash handling.
- Subscriptions and repeated payments: businesses with recurring charges can use tokenization and saved payment methods (where supported) to simplify re‑billing.
Practical tips for integration and operations
- Start in the sandbox. Request test keys and replicate your checkout flow in the test environment to catch logic and UX issues before going live.
- Use webhooks for real‑time updates. Configure webhook handlers to receive status changes (paid, refunded, chargeback) and verify Kaspi signatures for security.
- Implement idempotency. Ensure repeated webhook calls or API retries don’t create duplicate order states — use the unique invoice_id/order_id to match events.
- Log and monitor. Keep structured logs for payment events and set alerting for failed payouts or increases in declined transactions.
- Handle declined cards gracefully. Show clear messaging and fallback options (other cards, Kaspi wallet, QR) to reduce lost sales.
- Agree payout terms upfront. Clarify payout schedule, currency handling and any hold periods with your Kaspi account manager to avoid surprises in cash flow.
Common problems and how to solve them
Typical issues and practical solutions:
- Delayed payouts. Causes: risk checks, new account review, or mismatched settlement details. Action: contact your Kaspi manager, verify bank details, and provide requested documents promptly.
- Failed webhook processing. Causes: network, authentication, or unhandled payloads. Action: implement retries, validate payload signatures, and keep idempotent handlers.
- High chargeback rate. Causes: product misdescription, delivery problems, or fraud. Action: improve product pages, add tracked delivery, and collect evidence (proof of delivery, correspondence) to speed disputes.
- Reconciliation mismatches. Causes: different order IDs, refunds processed outside API, or timing differences. Action: use invoice_id consistently, automate reconciliation via API and keep a reconciliation log.
How to evaluate Kaspi Pay effectiveness for your business
Use these metrics to measure impact:
- Conversion rate at checkout — compare before and after Kaspi Pay integration.
- Average order value (AOV) — check if easier payment raises AOV.
- Payment acceptance rate — share of successful authorizations vs attempts.
- Payout timing and cash flow — how quickly funds reach your account and effect on working capital.
- Operational overhead — time saved on manual reconciliation and dispute handling.
Run an A/B test if possible: route a portion of traffic to Kaspi Pay and compare conversion, chargebacks and net revenue to your current gateway.
Conclusion
Kaspi Pay offers a localized, familiar payment experience for Kazakhstan buyers and a set of tools that help sellers increase conversion, speed up order processing and automate accounting. Evaluate fees, payout terms and integration effort relative to expected uplift in sales to decide if Kaspi Pay suits your business.
Часто задаваемые вопросы
- How do I connect Kaspi Pay to an online store and what documents are required?
- First register in the Kaspi merchant cabinet and submit an acquiring application — a manager will tell you which document packages are needed. Typically you need settlement account details, registration certificate (BIN for legal entities or IIN/certificate for sole proprietors) and a power of attorney if required. Integration is possible via ready CMS modules or via API — test keys are provided for testing.
- What are Kaspi Pay fees and what do they depend on?
- The fee size depends on the transaction type (cards, Kaspi wallet, QR), the seller's turnover and the terms of the agreement with Kaspi. Large sellers can get individual rates and discounts under contract. Exact rates and fee calculations are shown in your agreement and merchant dashboard.
- How long do payouts take to reach the seller and can the payout schedule be changed?
- Payout timing depends on the tariff plan and contract terms: payouts can be scheduled (daily, weekly or on an agreed cycle). For new accounts or when risk is elevated there may be additional review delays. You can change payout frequency or terms through your Kaspi manager or after updating the contract.
- How do I set up automatic reconciliation of payments via API and webhooks?
- Request access to production keys, connect the sandbox and configure a webhook handler on your server to receive notifications about transaction statuses. Verify the Kaspi message signature for security and use unique order identifiers (invoice_id) for matching. Implement logging and retry handling (idempotency) to automatically mark paid and canceled orders in your accounting system.
- How to process refunds and handle disputes in Kaspi Pay?
- A refund is initiated through the merchant dashboard or API with a specified reason and amount; the refund method depends on the original payment method. For disputes collect supporting documents (receipts, correspondence, tracking) and send them to Kaspi support to start a chargeback or investigation. Keep a returns log and inform the buyer promptly — this speeds up conflict resolution.
