{"id":2181,"date":"2026-09-02T13:07:58","date_gmt":"2026-09-02T13:07:58","guid":{"rendered":"https:\/\/group-starlight.com\/?page_id=2181"},"modified":"2026-09-02T18:43:40","modified_gmt":"2026-09-02T18:43:40","slug":"docs","status":"publish","type":"page","link":"https:\/\/group-starlight.com\/ru\/products\/kz-pay\/docs\/","title":{"rendered":"KZ Pay Docs"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><div class=\"vc_row wpb_row vc_row-fluid\"><div class=\"wpb_column vc_column_container vc_col-sm-12\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\t\t<article class=\"starlight-resource-page starlight-resource-page--docs starlight-resource-page--auto starlight-resource-page--hierarchy\" aria-labelledby=\"starlight-docs-title\">\r\n\t\t\t<div class=\"starlight-resource-page__orb starlight-resource-page__orb--one\" aria-hidden=\"true\"><\/div>\r\n\t\t\t<div class=\"starlight-resource-page__orb starlight-resource-page__orb--two\" aria-hidden=\"true\"><\/div>\r\n\r\n\t\t\t<div class=\"starlight-resource-page__container\">\r\n\t\t\t\t\t\t\t\t<header class=\"starlight-resource-page__hero starlight-resource-page__hero--docs\">\r\n\t\t\t<div class=\"starlight-resource-page__hero-copy\">\r\n\t\t\t\t<div class=\"starlight-resource-page__eyebrow\">\r\n\t\t\t\t\t<svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M9 2l1.4 4.6L15 8l-4.6 1.4L9 14l-1.4-4.6L3 8l4.6-1.4L9 2z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t\t<span>KZ PAY DOCUMENTATION<\/span>\r\n\t\t\t\t<\/div>\r\n\t\t\t\t<h1 id=\"starlight-docs-title\">KZ Pay Documentation<\/h1>\r\n\t\t\t\t<p>Learn how to install, connect and configure KZ Pay for WooCommerce, from license activation and Kaspi Pay setup to checkout testing and troubleshooting.<\/p>\r\n\t\t\t\t<div class=\"starlight-resource-page__actions\">\r\n\t\t\t\t\t\t\t<a class=\"starlight-resource-page__button starlight-resource-page__button--primary\" href=\"\/ru\/products\/kz-pay\/\">\r\n\t\t\t\t\t\t<span>View product page<\/span>\r\n\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t<\/a>\r\n\t\t\t\t\t\t\t\t\t<a class=\"starlight-resource-page__button starlight-resource-page__button--resource\" href=\"\/ru\/guides\/connect-kaspi-pay-to-woocommerce\/\">\r\n\t\t\t\t\t\t\t<span class=\"starlight-resource-page__button-icon\"><svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 28 28\"><path d=\"M8 4h9l5 5v15H8a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2Z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linejoin=\"round\"\/><path d=\"M17 4v6h5M10 14h8M10 18h8M10 22h5\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\"\/><\/svg><\/span>\r\n\t\t\t\t\t\t<span>Open setup guide<\/span>\r\n\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t<\/a>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<ul class=\"starlight-resource-page__badges\" aria-label=\"Page highlights\">\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Getting started<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Kaspi Pay connection<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Checkout testing<\/span><\/li>\r\n\t\t\t\t\t<\/ul>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<nav class=\"starlight-resource-page__hero-visual\" aria-label=\"Product Resources\">\r\n\t\t\t<div class=\"starlight-resource-page__resource-heading\">\r\n\t\t\t\t<span class=\"starlight-resource-page__resource-brand\"><svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M9 2l1.4 4.6L15 8l-4.6 1.4L9 14l-1.4-4.6L3 8l4.6-1.4L9 2z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linejoin=\"round\"\/><\/svg>Group Starlight<\/span>\r\n\t\t\t\t<h2>Product Resources<\/h2>\r\n\t\t\t<\/div>\r\n\t\t\t<div class=\"starlight-resource-page__resource-links\">\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a class=\"starlight-resource-page__resource-link\" href=\"\/ru\/products\/kz-pay\/docs\/\">\r\n\t\t\t\t\t\t<span class=\"starlight-resource-page__resource-icon\"><svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 28 28\"><path d=\"M8 4h9l5 5v15H8a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2Z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linejoin=\"round\"\/><path d=\"M17 4v6h5M10 14h8M10 18h8M10 22h5\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\"\/><\/svg><\/span>\r\n\t\t\t\t\t\t<span class=\"starlight-resource-page__resource-copy\">\r\n\t\t\t\t\t\t\t<strong>Documentation<\/strong>\r\n\t\t\t\t\t\t\t<span>Setup, configuration and support<\/span>\r\n\t\t\t\t\t\t<\/span>\r\n\t\t\t\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a class=\"starlight-resource-page__resource-link\" href=\"\/ru\/guides\/\">\r\n\t\t\t\t\t\t<span class=\"starlight-resource-page__resource-icon\"><svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 28 28\"><path d=\"M9 8h13M9 14h13M9 20h13M5 8l1 1 2-3M5 14l1 1 2-3M5 20l1 1 2-3\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><\/span>\r\n\t\t\t\t\t\t<span class=\"starlight-resource-page__resource-copy\">\r\n\t\t\t\t\t\t\t<strong>Practical Guides<\/strong>\r\n\t\t\t\t\t\t\t<span>Step-by-step integration tutorials<\/span>\r\n\t\t\t\t\t\t<\/span>\r\n\t\t\t\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t<\/nav>\r\n\t\t\t\t<\/header>\r\n\t\t\r\n\t\t\t\t<nav class=\"starlight-resource-page__docs-nav\" aria-label=\"KZ Pay documentation sections\">\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#getting-started\">Getting Started<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#installation\">Installation<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#kaspi-pay-connection\">Kaspi Pay Connection<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#checkout-setup\">Checkout Setup<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#payments\">Payments<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#troubleshooting\">Troubleshooting<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#faq\">FAQ<\/a>\r\n\t\t\t\t\t\t\t\t\t\t\t<a href=\"#support\">Support<\/a>\r\n\t\t\t\t\t<\/nav>\r\n\t\t\r\n\t\t<section id=\"setup-path\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">Setup path<\/span>\r\n\t\t\t<h2>Configure KZ Pay in the right order<\/h2>\r\n\t\t\t<p>Start with requirements, then install, activate, connect Kaspi Pay, register this store and enable checkout only after readiness is complete.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__docs-grid\">\r\n\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Before installation<\/h3>\r\n\t\t\t<p>Confirm WordPress, WooCommerce, HTTPS, KZT currency, Kaspi Pay access, a Kaspi Pay API key and a trade point before enabling checkout.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Install and activate<\/h3>\r\n\t\t\t<p>Upload the KZ Pay ZIP, activate it in WordPress and complete the Freemius license or trial flow.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Connect Kaspi Pay<\/h3>\r\n\t\t\t<p>Save the Kaspi Pay API key, test the connection, load trade points, select one and register this store.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Enable checkout<\/h3>\r\n\t\t\t<p>Enable KZ Pay only after the API key, trade point and store registration are ready.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Payments and orders<\/h3>\r\n\t\t\t<p>Customers pay through a QR code or mobile payment link. KZ Pay tracks the result and updates the matching WooCommerce order.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Troubleshooting and support<\/h3>\r\n\t\t\t<p>Use issue-based checks first, then contact support without sending credentials or full sensitive logs.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"getting-started\" class=\"starlight-resource-page__section starlight-resource-page__section--split\">\r\n\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t<span class=\"starlight-resource-page__kicker\">Before installation<\/span>\r\n\t\t\t\t<h2>Getting Started<\/h2>\r\n\t\t\t\t<p>Before installing KZ Pay, make sure your WordPress store and Kaspi Pay account meet the required conditions.<\/p>\r\n\t\t\t\t\t\t<ul class=\"starlight-resource-page__check-list starlight-resource-page__docs-check-list\">\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>WordPress 6.9 or newer is available<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>WooCommerce 7.0 or newer is installed and active<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>The production site uses HTTPS<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>WooCommerce store currency is KZT<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>The merchant has Kaspi Pay access<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>The merchant has a Kaspi Pay API key<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>At least one Kaspi Pay trade point is configured<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>The server runs PHP 8.1 or newer with OpenSSL<\/span><\/li>\r\n\t\t\t\t\t<\/ul>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t<div class=\"starlight-resource-page__panel starlight-resource-page__docs-note\">\r\n\t\t\t\t<span class=\"starlight-resource-page__kicker\">Important<\/span>\r\n\t\t\t\t<h2>Kaspi Pay access is separate<\/h2>\r\n\t\t\t\t<p>KZ Pay does not provide a Kaspi Pay account or API key. These must be obtained separately by the merchant through Kaspi Pay.<\/p>\r\n\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"installation\" class=\"starlight-resource-page__section starlight-resource-page__section--split\">\r\n\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t\t\t<span class=\"starlight-resource-page__kicker\">Install the plugin<\/span>\r\n\t\t\t\t\t\t<h2>Installation<\/h2>\r\n\t\t\t\t\t\t\t<p>Install KZ Pay like a standard commercial WordPress plugin ZIP, then open its settings before enabling checkout.<\/p>\r\n\t\t\t\t\t\t\t\t\t\t\t\t<ol class=\"starlight-resource-page__docs-steps\">\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Download the ZIP package<\/strong>\r\n\t\t\t\t\t<span>Use the installable KZ Pay ZIP package from your purchase or download area.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Upload in WordPress<\/strong>\r\n\t\t\t\t\t<span>In WordPress, go to Plugins &gt; Add New &gt; Upload Plugin.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Install and activate<\/strong>\r\n\t\t\t\t\t<span>Upload the ZIP file, install it and activate the plugin.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Open KZ Pay settings<\/strong>\r\n\t\t\t\t\t<span>Use the Kaspi Pay admin menu or WooCommerce &gt; Settings &gt; Payments &gt; KZ Pay for WooCommerce.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t<\/ol>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t\t\t<span class=\"starlight-resource-page__kicker\">Activate access<\/span>\r\n\t\t\t\t\t\t<h2>License Activation<\/h2>\r\n\t\t\t\t\t\t\t<p>After activation, complete the Freemius license or trial flow in WordPress. Product downloads, updates, license-managed access and technical support depend on an active trial or subscription.<\/p>\r\n\t\t\t\t\t\t\t\t\t\t\t\t<ol class=\"starlight-resource-page__docs-steps\">\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Start activation<\/strong>\r\n\t\t\t\t\t<span>Follow the Freemius prompt shown after plugin activation.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Enter license details<\/strong>\r\n\t\t\t\t\t<span>Use the purchase email or license key from the KZ Pay customer account.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Confirm active status<\/strong>\r\n\t\t\t\t\t<span>Confirm that Freemius shows an active trial or subscription before relying on downloads, updates or support access.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>If activation fails<\/strong>\r\n\t\t\t\t\t<span>Check the purchase email, license status and WordPress connectivity to Freemius, then try again.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t<\/ol>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t\t\t<\/section>\r\n\r\n\t\t<section id=\"kaspi-pay-connection\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">Connect Kaspi Pay<\/span>\r\n\t\t\t<h2>Kaspi QR Connection<\/h2>\r\n\t\t\t<p>The KZ Pay settings screen uses the same customer-facing labels shown below. Complete these steps before checkout is enabled.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__section--split\">\r\n\t\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t\t<h2>Kaspi Pay API key and setup steps<\/h2>\r\n\t\t\t\t\t\t\t<p>The Kaspi Pay API key lets KZ Pay connect your WooCommerce store to Kaspi Pay from the WordPress server. Do not paste real credentials into support messages, screenshots or public documentation.<\/p>\r\n\t\t\t\t\t\t\t\t\t\t\t\t<ol class=\"starlight-resource-page__docs-steps\">\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Enter Kaspi Pay API key<\/strong>\r\n\t\t\t\t\t<span>Open Kaspi QR Connection and paste the production API key issued to your organization.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Save API key<\/strong>\r\n\t\t\t\t\t<span>Click Save API key. The saved key is encrypted and is not displayed again.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Test connection<\/strong>\r\n\t\t\t\t\t<span>Click Test connection before loading trade points.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Load trade points<\/strong>\r\n\t\t\t\t\t<span>Click Load trade points to fetch available Kaspi Pay trade points.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Select Trade point<\/strong>\r\n\t\t\t\t\t<span>Choose the Trade point that should receive payments from this WooCommerce store.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Register this store<\/strong>\r\n\t\t\t\t\t<span>Click Register this store. KZ Pay sends the generated KZ Pay Device ID and selected trade point to Kaspi Pay.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Enable checkout<\/strong>\r\n\t\t\t\t\t<span>After the readiness list is complete, enable KZ Pay at WooCommerce checkout and save.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t<\/ol>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t\t<h2>Trade Point &amp; Store Registration<\/h2>\r\n\t\t\t\t\t\t\t<p>A trade point is the Kaspi Pay location or point that should receive payments from this WooCommerce store. Store registration links this WordPress installation to the selected trade point.<\/p>\r\n\t\t\t\t\t\t\t\t\t\t<div class=\"starlight-resource-page__docs-mini-grid\">\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Trade point<\/h3>\r\n\t\t\t<p>Select the Kaspi Pay trade point that should receive checkout payments.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>KZ Pay Device ID<\/h3>\r\n\t\t\t<p>Generated automatically for this WordPress installation and shown in the settings screen.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Store registration<\/h3>\r\n\t\t\t<p>The settings screen shows Registered with Kaspi Pay after successful registration.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Disconnect this store<\/h3>\r\n\t\t\t<p>Use this only when the store should be unregistered or moved; checkout is disabled after disconnecting.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"checkout-setup\" class=\"starlight-resource-page__section starlight-resource-page__section--split\">\r\n\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t<span class=\"starlight-resource-page__kicker\">Enable checkout<\/span>\r\n\t\t\t\t<h2>Checkout Setup<\/h2>\r\n\t\t\t\t<p>Enable KZ Pay at checkout only after the connection and registration steps are complete.<\/p>\r\n\t\t\t\t\t\t<ul class=\"starlight-resource-page__check-list starlight-resource-page__docs-check-list\">\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Kaspi Pay API key saved<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Trade point selected<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Store registered with Kaspi Pay<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Enable KZ Pay at WooCommerce checkout is checked<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Checkout and order currency is KZT<\/span><\/li>\r\n\t\t\t\t\t<\/ul>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t<h2>Before Accepting Live Payments<\/h2>\r\n\t\t\t\t<p>Use a controlled real checkout before relying on KZ Pay for customer payments. Confirm that the QR or payment-link flow completes and that the matching WooCommerce order receives the final payment result.<\/p>\r\n\t\t\t\t\t\t<ul class=\"starlight-resource-page__check-list starlight-resource-page__docs-check-list\">\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>API key configured<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Correct trade point selected<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Store registered<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>KZ Pay enabled at checkout<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>Checkout currency is KZT<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>One controlled payment completed<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>WooCommerce receives the final result<\/span><\/li>\r\n\t\t\t\t\t\t\t<li><svg class=\"starlight-resource-page__check-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9.4l3 3L14 5.6\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg><span>The order updates correctly<\/span><\/li>\r\n\t\t\t\t\t<\/ul>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"payments\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">Payments<\/span>\r\n\t\t\t<h2>How KZ Pay handles payments<\/h2>\r\n\t\t\t<p>After WooCommerce creates an order, KZ Pay sends the customer to a protected payment page and creates either a Kaspi QR request or a mobile payment link.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__section--split\">\r\n\t\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t\t<h2>Kaspi QR Payments<\/h2>\r\n\t\t\t\t\t\t\t\t\t\t\t\t<ol class=\"starlight-resource-page__docs-steps\">\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Customer places an order<\/strong>\r\n\t\t\t\t\t<span>WooCommerce creates the order and redirects the customer to the KZ Pay payment page.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>KZ Pay creates a payment request<\/strong>\r\n\t\t\t\t\t<span>The plugin sends the order amount and generated payment reference to Kaspi Pay.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>Customer confirms payment<\/strong>\r\n\t\t\t\t\t<span>Desktop customers scan the QR code in Kaspi. Mobile customers can continue through the Kaspi app link.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>KZ Pay tracks the result<\/strong>\r\n\t\t\t\t\t<span>The plugin checks the payment status from the WordPress server.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t\t\t<li>\r\n\t\t\t\t\t<strong>WooCommerce updates the order<\/strong>\r\n\t\t\t\t\t<span>WooCommerce is updated only after a final payment result is received and validated.<\/span>\r\n\t\t\t\t<\/li>\r\n\t\t\t\t\t<\/ol>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t\t<h2>Mobile Payment Links<\/h2>\r\n\t\t\t\t\t<p>For mobile checkout, KZ Pay can provide a payment link so the customer can continue the payment flow in Kaspi on the same device instead of scanning the same screen.<\/p>\r\n\t\t\t\t\t<h2>Payment Status &amp; WooCommerce Orders<\/h2>\r\n\t\t\t\t\t<p>KZ Pay tracks the payment status and updates the corresponding WooCommerce order after a final payment result is received.<\/p>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__docs-mini-grid\">\r\n\t\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Waiting for payment<\/h3>\r\n\t\t\t<p>The customer is viewing the QR code or payment link and Kaspi has not returned a final result.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Payment completed<\/h3>\r\n\t\t\t<p>Kaspi returns a processed result with valid transaction data and a matching amount.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Payment failed or expired<\/h3>\r\n\t\t\t<p>Kaspi returns a terminal failure, cancellation or expiration state. The customer can retry when the stored state allows it.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Manual review<\/h3>\r\n\t\t\t<p>KZ Pay cannot safely complete or fail the order automatically and records that administrator review is needed.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__docs-warning\">\r\n\t\t\t\t\t\t<h3>Refunds<\/h3>\r\n\t\t\t\t\t\t<p>Automatic API refunds are not available with the current Kaspi QR integration. Process the refund in the Kaspi Pay app first, then record it in WooCommerce. Recording a refund in WooCommerce is not necessarily the same operation as returning money through Kaspi Pay.<\/p>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t<\/div>\r\n\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"troubleshooting\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">Troubleshooting<\/span>\r\n\t\t\t<h2>Common setup checks<\/h2>\r\n\t\t\t<p>Use these checks before escalating to technical support. Never include API keys, passwords or full sensitive logs in a support message.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t\t\t<div class=\"starlight-resource-page__docs-issue-grid\">\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>KZ Pay does not appear at checkout<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>The gateway is disabled, setup is incomplete, the currency is not KZT, or license status needs review.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Check the readiness list in Checkout Setup, confirm the order currency is KZT and review the Freemius license or trial status.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Complete API key, trade point and store registration, then enable and save checkout settings.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Connection test fails<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>The API key is missing, invalid or cannot reach Kaspi Pay from the server.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Confirm the production API key was copied correctly and the server can make outbound HTTPS requests.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Save the key again and run Test connection. If it still fails, contact support without sending the key.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Trade points do not load<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>Kaspi Pay returned no trade points or the API key does not have access to them.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Confirm the merchant has configured trade points in Kaspi Pay.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Use Load trade points again after Kaspi Pay setup is corrected.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Store registration fails<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>No trade point is selected or Kaspi Pay rejected registration for this store.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Select the correct Trade point and confirm the API key belongs to that organization.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Click Register this store again or contact support with the request reference if available.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>QR payment cannot be created<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>Checkout is not ready, GD\/PNG support is missing or Kaspi rejected the payment request.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Check KZT currency, readiness status, server PHP extensions and WooCommerce order total.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Correct the issue and retry the order. Use another payment method if the customer is waiting.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Payment remains pending<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>Kaspi has not returned a final result or WordPress scheduled actions are delayed.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Check WooCommerce order notes and make sure WordPress cron or Action Scheduler is running.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Wait for the next status check or contact support with the WooCommerce order ID.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Customer completed payment but WooCommerce did not update<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>KZ Pay could not safely validate the final result or local completion needs review.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Check the WooCommerce order notes for manual review, amount mismatch or missing transaction data.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Do not create duplicate payments. Contact support with the order ID and safe log excerpt.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Payment link does not open<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>The customer is using an unsupported browser\/app path or the returned link is no longer active.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Ask the customer to retry checkout and confirm they can open Kaspi on the device.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Retry the payment when the previous attempt is terminal or use another payment method.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>Payment expired<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>The QR code or payment link was not confirmed before the provider timeout.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Confirm whether the WooCommerce order shows failed, expired or retry state.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Let the customer retry only when KZ Pay shows that retry is allowed.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card starlight-resource-page__docs-issue\">\r\n\t\t\t\t\t<h3>License activation fails<\/h3>\r\n\t\t\t\t\t<dl>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>Possible cause<\/dt>\r\n\t\t\t\t\t\t\t<dd>The license is inactive, entered with the wrong email or Freemius cannot validate it.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to check<\/dt>\r\n\t\t\t\t\t\t\t<dd>Check the KZ Pay customer account, purchase email and subscription status.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t\t<div>\r\n\t\t\t\t\t\t\t<dt>What to do next<\/dt>\r\n\t\t\t\t\t\t\t<dd>Renew or activate the license, then reload the KZ Pay settings page.<\/dd>\r\n\t\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/dl>\r\n\t\t\t\t<\/article>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t<\/section>\r\n\r\n\t\t<section id=\"faq\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">FAQ<\/span>\r\n\t\t\t<h2>KZ Pay documentation FAQ<\/h2>\r\n\t\t\t<p>Short answers to common setup and support questions.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t\t\t<div class=\"starlight-resource-page__docs-faq\">\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>Where do I enter my Kaspi Pay API key?<\/summary>\r\n\t\t\t\t\t<p>Open the Kaspi Pay admin menu or WooCommerce &gt; Settings &gt; Payments &gt; KZ Pay for WooCommerce, then use the Kaspi QR Connection section.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>How do I select a trade point?<\/summary>\r\n\t\t\t\t\t<p>Click Load trade points, then select the Trade point that should receive payments from this WooCommerce store.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>Why does KZ Pay register my store?<\/summary>\r\n\t\t\t\t\t<p>Registration links this WordPress installation and its generated KZ Pay Device ID to the selected Kaspi Pay trade point.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>Why is KZ Pay not visible at checkout?<\/summary>\r\n\t\t\t\t\t<p>Check whether setup is complete, the gateway is enabled, the checkout currency is KZT and the Freemius license or trial status is active.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>How do customers pay on mobile?<\/summary>\r\n\t\t\t\t\t<p>Mobile customers can continue through a Kaspi payment link on the same device.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>How does KZ Pay detect a successful payment?<\/summary>\r\n\t\t\t\t\t<p>KZ Pay checks the Kaspi payment status from the WordPress server and updates the matching WooCommerce order after a final valid result.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>Can I use a currency other than KZT?<\/summary>\r\n\t\t\t\t\t<p>No. KZ Pay is available only for KZT checkout\/orders.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>How do refunds work?<\/summary>\r\n\t\t\t\t\t<p>Process the refund in the Kaspi Pay app first, then record it in WooCommerce. Automatic API refunds are not available with the current Kaspi QR integration.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>Can I move KZ Pay to another WordPress installation?<\/summary>\r\n\t\t\t\t\t<p>A new WordPress installation receives its own KZ Pay Device ID and must be registered again with the correct trade point.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t\t\t<details>\r\n\t\t\t\t\t<summary>What information should I send to support?<\/summary>\r\n\t\t\t\t\t<p>Send your WordPress, WooCommerce and KZ Pay versions, the WooCommerce order ID and a safe description of the issue. Never send the Kaspi Pay API key.<\/p>\r\n\t\t\t\t<\/details>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t<\/section>\r\n\r\n\t\t<section id=\"technical-details\" class=\"starlight-resource-page__section\">\r\n\t\t\t\t\t<header class=\"starlight-resource-page__section-header\">\r\n\t\t\t<span class=\"starlight-resource-page__kicker\">Technical details<\/span>\r\n\t\t\t<h2>Developer-level notes<\/h2>\r\n\t\t\t<p>These details help administrators and developers understand the implementation without making ordinary setup harder.<\/p>\r\n\t\t<\/header>\r\n\t\t\t\t\t<div class=\"starlight-resource-page__docs-grid\">\r\n\t\t\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>First Scheme (Simplified Access)<\/h3>\r\n\t\t\t<p>The current plugin is built for Kaspi Public QR API Scheme 1. Merchant setup does not require certificate flow configuration in WordPress.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>API authorization model<\/h3>\r\n\t\t\t<p>KZ Pay sends the saved Kaspi Pay API key from the server side. The key is never printed in this public documentation.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>DeviceToken<\/h3>\r\n\t\t\t<p>Kaspi Pay returns a DeviceToken during store registration. KZ Pay stores it for future payment requests.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Payment status polling<\/h3>\r\n\t\t\t<p>The plugin checks Kaspi payment status server side and stores the first working status API version when needed.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>API status terminology<\/h3>\r\n\t\t\t<p>Common internal statuses include QrTokenCreated, RemotePaymentCreated, Wait, Processing, Processed and terminal failure states.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t<article class=\"starlight-resource-page__doc-card\">\r\n\t\t\t<h3>Supported API behavior<\/h3>\r\n\t\t\t<p>The current integration supports QR checkout, mobile payment links, device registration, trade point loading and server-side payment status tracking.<\/p>\r\n\t\t<\/article>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/section>\r\n\r\n\t\t<section id=\"support\" class=\"starlight-resource-page__section starlight-resource-page__section--split\">\r\n\t\t\t<div class=\"starlight-resource-page__callout\">\r\n\t\t\t\t<span class=\"starlight-resource-page__kicker\">Next step<\/span>\r\n\t\t\t\t<h2>Need Help?<\/h2>\r\n\t\t\t\t<p>If you cannot resolve an issue using this documentation, contact KZ Pay Support at support@group-starlight.com. Include your WordPress, WooCommerce and KZ Pay versions together with the WooCommerce order ID related to the issue.<\/p>\r\n\t\t\t\t<p class=\"starlight-resource-page__docs-security-note\">Never send your Kaspi Pay API key, passwords, full sensitive logs or credentials by email or support message.<\/p>\r\n\t\t\t\t\t\t<a class=\"starlight-resource-page__button starlight-resource-page__button--resource\" href=\"mailto:support@group-starlight.com\">\r\n\t\t\t\t\t\t\t<span class=\"starlight-resource-page__button-icon\"><svg class=\"starlight-resource-page__icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 28 28\"><path d=\"M8 4h9l5 5v15H8a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2Z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linejoin=\"round\"\/><path d=\"M17 4v6h5M10 14h8M10 18h8M10 22h5\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\"\/><\/svg><\/span>\r\n\t\t\t\t\t\t<span>Contact support<\/span>\r\n\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t<\/a>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t<div class=\"starlight-resource-page__panel\">\r\n\t\t\t\t<span class=\"starlight-resource-page__kicker\">Related resources<\/span>\r\n\t\t\t\t<h2>Continue with the right page<\/h2>\r\n\t\t\t\t<p>Use the product page for pricing and limits, or the guides when you need a broader implementation explanation.<\/p>\r\n\t\t\t\t\t\t<div class=\"starlight-resource-page__link-list\">\r\n\t\t\t\t\t\t\t<a href=\"\/ru\/products\/kz-pay\/\">\r\n\t\t\t\t\t<strong>KZ Pay product page<\/strong>\r\n\t\t\t\t\t<span>Pricing, requirements, limits and purchase information.<\/span>\r\n\t\t\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<a href=\"\/ru\/guides\/connect-kaspi-pay-to-woocommerce\/\">\r\n\t\t\t\t\t<strong>WooCommerce setup guide<\/strong>\r\n\t\t\t\t\t<span>A broader implementation guide for connecting Kaspi Pay to WooCommerce.<\/span>\r\n\t\t\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t<\/a>\r\n\t\t\t\t\t\t\t<a href=\"\/ru\/guides\/kaspi-qr-woocommerce\/\">\r\n\t\t\t\t\t<strong>Kaspi QR guide<\/strong>\r\n\t\t\t\t\t<span>A customer-flow explanation for QR payments, mobile links and order updates.<\/span>\r\n\t\t\t\t\t<svg class=\"starlight-resource-page__arrow-icon\" aria-hidden=\"true\" focusable=\"false\" viewbox=\"0 0 18 18\"><path d=\"M4 9h9M10 5l4 4-4 4\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\/><\/svg>\t\t\t\t<\/a>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/section>\r\n\t\t\t\t\t<\/div>\r\n\t\t<\/article>\r\n\t\t<\/div><\/div><\/div><\/div>\n<\/div>","protected":false},"excerpt":{"rendered":"KZ PAY DOCUMENTATION KZ Pay Documentation Learn how to install, connect and configure KZ Pay for WooCommerce, from&hellip;","protected":false},"author":2,"featured_media":0,"parent":2144,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"csco_singular_sidebar":"","csco_page_header_type":"","csco_page_load_nextpost":"","footnotes":"","_members_access_role":[],"_members_access_error":""},"class_list":["post-2181","page","type-page","status-publish","cs-entry"],"_links":{"self":[{"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/pages\/2181","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/comments?post=2181"}],"version-history":[{"count":2,"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/pages\/2181\/revisions"}],"predecessor-version":[{"id":2188,"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/pages\/2181\/revisions\/2188"}],"up":[{"embeddable":true,"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/pages\/2144"}],"wp:attachment":[{"href":"https:\/\/group-starlight.com\/ru\/wp-json\/wp\/v2\/media?parent=2181"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}