{"id":405853,"date":"2026-11-16T19:18:51","date_gmt":"2026-11-16T19:18:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/sablepay\/"},"modified":"2026-11-16T20:14:51","modified_gmt":"2026-11-16T20:14:51","slug":"sablepay","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/sablepay\/","author":23606481,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.3.13","stable_tag":"1.3.13","tested":"7.1.4","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"SablePay","header_author":"SablePay","header_description":"Accept stablecoin payments with QR codes, live status tracking and a ready-made payment window. Includes a payment button shortcode, a secure REST proxy and developer SDKs for PHP and JavaScript.","last_updated":"2026-11-16 20:14:51","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/sablepay.io","rating":5,"author_block_rating":0,"active_installs":0,"downloads":40,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.3.12":{"tag":"1.3.12","author":"rahul153","date":"2026-11-16 19:18:40","revision":3805946},"1.3.13":{"tag":"1.3.13","author":"rahul153","date":"2026-11-16 20:14:51","revision":3806045}},"upgrade_notice":{"1.3.13":"<p>Fixes the SablePay API endpoints. Please update: 1.3.12 cannot reach the API.<\/p>","1.3.12":"<p>Initial release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3805946,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3805946,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3805946,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3805946,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.3.12","1.3.13"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3805946,"resolution":"1","location":"assets","locale":"","width":900,"height":760},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3805946,"resolution":"2","location":"assets","locale":"","width":900,"height":760}},"screenshots":{"1":"The payment window: amount, converted stablecoin amount, QR code and expiry countdown.","2":"Payment successful, with transaction details.","3":"Settings \u2192 SablePay: credentials, environment and connection test."}},"plugin_section":[],"plugin_tags":[157818,1887,1373,231844,209195],"plugin_category":[45],"plugin_contributors":[293254],"plugin_business_model":[],"class_list":["post-405853","plugin","type-plugin","status-publish","hentry","plugin_tags-crypto-payments","plugin_tags-payments","plugin_tags-qr-code","plugin_tags-stablecoin","plugin_tags-usdc","plugin_category-ecommerce","plugin_contributors-rahul153","plugin_committers-rahul153"],"banners":{"banner":"https:\/\/ps.w.org\/sablepay\/assets\/banner-772x250.png?rev=3805946","banner_2x":"https:\/\/ps.w.org\/sablepay\/assets\/banner-1544x500.png?rev=3805946","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/sablepay\/assets\/icon-128x128.png?rev=3805946","icon_2x":"https:\/\/ps.w.org\/sablepay\/assets\/icon-256x256.png?rev=3805946","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/sablepay\/assets\/screenshot-1.png?rev=3805946","caption":"The payment window: amount, converted stablecoin amount, QR code and expiry countdown."},{"src":"https:\/\/ps.w.org\/sablepay\/assets\/screenshot-2.png?rev=3805946","caption":"Payment successful, with transaction details."}],"raw_content":"<!--section=description-->\n<p>SablePay lets your customers pay in stablecoins by scanning a QR code with their phone or clicking to pay on the same device. The plugin handles the whole payment flow for you:<\/p>\n\n<ol>\n<li>A payment is created through the SablePay API.<\/li>\n<li>A payment window opens with the amount, a QR code and an expiry countdown.<\/li>\n<li>The plugin checks the payment status automatically until it is completed, failed or expired.<\/li>\n<li>The customer sees a success or failure screen, and your site can react to the result.<\/li>\n<\/ol>\n\n<h4>Features<\/h4>\n\n<ul>\n<li><strong>Payment button shortcode<\/strong>: add <code>[sablepay_button amount=\"10.50\"]<\/code> to any page or post. No code needed.<\/li>\n<li><strong>Ready-made payment window<\/strong>: QR code, converted stablecoin amount, \"click to pay\" link and an expiry countdown.<\/li>\n<li><strong>Live status tracking<\/strong>: checks every 3 seconds for the first minute, then backs off to every 10 seconds.<\/li>\n<li><strong>Secure by design<\/strong>: your API key is stored on your server and is never sent to visitors' browsers. Browser requests go through your own site (<code>\/wp-json\/sablepay\/v1\/<\/code>), protected by a nonce and per-IP rate limits.<\/li>\n<li><strong>Sandbox and live modes<\/strong>: the environment is detected from your API key.<\/li>\n<li><strong>Connection test<\/strong>: check your credentials from the settings screen.<\/li>\n<li><strong>Developer SDKs<\/strong>: a JavaScript SDK (<code>window.SablePay<\/code>) and a PHP SDK (<code>sablepay()<\/code>), with the same API as the SablePay Angular, React and Android SDKs.<\/li>\n<li><strong>Hooks for fulfilment<\/strong>: <code>sablepay_payment_completed<\/code>, <code>sablepay_payment_created<\/code>, <code>sablepay_create_payment_request<\/code> and more.<\/li>\n<li><strong>No external scripts<\/strong>: the QR code encoder and all assets are included in the plugin.<\/li>\n<\/ul>\n\n<h4>Shortcode<\/h4>\n\n<pre><code>[sablepay_button amount=\"10.50\" label=\"Pay with SablePay\" item=\"Coffee\" metadata=\"order_id:123\" success_url=\"\/thank-you\/\"]\n<\/code><\/pre>\n\n<ul>\n<li><code>amount<\/code> (required): payment amount, 0.01 to 1,000,000.<\/li>\n<li><code>label<\/code>: button text.<\/li>\n<li><code>item<\/code> \/ <code>quantity<\/code>: optional line item sent with the payment.<\/li>\n<li><code>metadata<\/code>: optional <code>key:value<\/code> pairs, separated by commas.<\/li>\n<li><code>success_url<\/code>: where to send the customer after payment. <code>?sablepay_payment_id=\u2026<\/code> is added to the URL.<\/li>\n<\/ul>\n\n<h4>For developers<\/h4>\n\n<pre><code>\/\/ JavaScript (enqueue with sablepay_enqueue() in PHP)\nSablePay.initializeFromWordPress();\nSablePay.launchPayment(\n  { amount: 10.5, metadata: { order_id: '123' } },\n  { onSuccess: (r) =&gt; console.log(r.transactionHash), onFailure: (e) =&gt; console.log(e.message) }\n);\n\n\/\/ PHP: always verify on the server before fulfilling an order\n$status = sablepay()-&gt;getPaymentStatus( $payment_id );\nif ( \\SablePay\\PaymentStatus::isCompleted( $status['status'] ) ) { \/* fulfil *\/ }\n<\/code><\/pre>\n\n<p>Hooks and filters: <code>sablepay_payment_created<\/code>, <code>sablepay_payment_status_checked<\/code>, <code>sablepay_payment_completed<\/code>, <code>sablepay_create_payment_request<\/code>, <code>sablepay_rest_permission<\/code>, <code>sablepay_rest_require_nonce<\/code>, <code>sablepay_rate_limits<\/code>, <code>sablepay_settings<\/code>, <code>sablepay_client_config<\/code>.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the <strong>SablePay payment API<\/strong>, operated by SablePay, to create stablecoin payments and check their status. This connection is required: the plugin cannot take payments without it.<\/p>\n\n<p><strong>When data is sent<\/strong><\/p>\n\n<ul>\n<li>When a visitor clicks a SablePay payment button, or your site calls <code>SablePay.launchPayment()<\/code>, the plugin creates a payment.<\/li>\n<li>While the payment window is open, the plugin checks the payment status every few seconds until the payment finishes.<\/li>\n<li>When an administrator clicks \"Test connection\" on the settings screen, the plugin fetches the most recent payment.<\/li>\n<li>When your own code calls the PHP SDK (for example <code>sablepay()-&gt;getPaymentStatus()<\/code>).<\/li>\n<\/ul>\n\n<p><strong>What data is sent<\/strong><\/p>\n\n<ul>\n<li>Your SablePay API key and Merchant ID, sent from your server only and never exposed to visitors.<\/li>\n<li>The payment amount, any line items (name, quantity, price, SKU) and any metadata you add (for example an order ID).<\/li>\n<li>Payment IDs, when checking a payment's status.<\/li>\n<\/ul>\n\n<p>The plugin does not send visitors' names, email addresses or IP addresses to SablePay. Requests go from your web server to:<\/p>\n\n<ul>\n<li>Sandbox: <code>https:\/\/sandbox-api.sablepay.io\/api\/v1\/<\/code><\/li>\n<li>Production: <code>https:\/\/api.sablepay.io\/api\/v1\/<\/code><\/li>\n<li>or a custom API base URL that you set on the settings screen.<\/li>\n<\/ul>\n\n<p>The customer completes the payment on SablePay's payment page, which is linked from the QR code, using their own wallet.<\/p>\n\n<ul>\n<li>SablePay Terms of Service: https:\/\/www.sablepay.io\/terms-of-service<\/li>\n<li>SablePay Privacy Policy: https:\/\/www.sablepay.io\/privacy-policy<\/li>\n<\/ul>\n\n<h3>Third-party libraries<\/h3>\n\n<ul>\n<li>qrcode-generator 1.4.4 by Kazuhiko Arase, MIT License: https:\/\/github.com\/kazuhikoarase\/qrcode-generator<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>In your WordPress admin, go to <strong>Plugins \u2192 Add New Plugin<\/strong>, search for <strong>SablePay<\/strong>, then click <strong>Install Now<\/strong> and <strong>Activate<\/strong>.<\/li>\n<li>Go to <strong>Settings \u2192 SablePay<\/strong>.<\/li>\n<li>Enter your <strong>API Key<\/strong> (<code>sable_sk_sand_\u2026<\/code> for sandbox, <code>sable_sk_live_\u2026<\/code> for production) and your <strong>Merchant ID<\/strong>. You can find both in your SablePay dashboard.<\/li>\n<li>Click <strong>Save Changes<\/strong>, then <strong>Test connection<\/strong>.<\/li>\n<li>Add <code>[sablepay_button amount=\"10.00\"]<\/code> to any page.<\/li>\n<\/ol>\n\n<p>Optional: define the credentials in <code>wp-config.php<\/code> instead. Values defined there override the settings screen:<\/p>\n\n<pre><code>define( 'SABLEPAY_API_KEY', 'sable_sk_live_...' );\ndefine( 'SABLEPAY_MERCHANT_ID', 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' );\n<\/code><\/pre>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20sablepay%20account%3F\"><h3>Do I need a SablePay account?<\/h3><\/dt>\n<dd><p>Yes. Sign up at https:\/\/www.sablepay.io to get an API key and Merchant ID. Use a sandbox key (<code>sable_sk_sand_\u2026<\/code>) for testing.<\/p><\/dd>\n<dt id=\"which%20coins%20and%20networks%20are%20supported%3F\"><h3>Which coins and networks are supported?<\/h3><\/dt>\n<dd><p>That depends on your SablePay account. Customers can pay with the stablecoins and networks enabled for your merchant account. The token and network actually used are shown on the success screen.<\/p><\/dd>\n<dt id=\"is%20my%20api%20key%20safe%3F\"><h3>Is my API key safe?<\/h3><\/dt>\n<dd><p>Yes. The key is stored on your server and is only used for server-to-server requests. Visitors' browsers talk to your own site's REST endpoint, never directly to SablePay with your key.<\/p><\/dd>\n<dt id=\"how%20do%20i%20know%20a%20payment%20was%20really%20completed%3F\"><h3>How do I know a payment was really completed?<\/h3><\/dt>\n<dd><p>Don't rely only on the browser's success screen. Check the status on the server with <code>sablepay()-&gt;getPaymentStatus( $id )<\/code>, or use the <code>sablepay_payment_completed<\/code> action. The plugin provides both.<\/p><\/dd>\n<dt id=\"can%20i%20control%20the%20amount%20on%20the%20server%3F\"><h3>Can I control the amount on the server?<\/h3><\/dt>\n<dd><p>Yes. Use the <code>sablepay_create_payment_request<\/code> filter to recalculate the amount (for example from an order), or return a <code>WP_Error<\/code> to reject the request.<\/p><\/dd>\n<dt id=\"my%20page%20cache%20serves%20old%20pages%20and%20payments%20fail%20with%20%22session%20has%20expired%22\"><h3>My page cache serves old pages and payments fail with \"session has expired\"<\/h3><\/dt>\n<dd><p>Exclude pages with payment buttons from your page cache, or use the <code>sablepay_rest_require_nonce<\/code> filter (rate limiting still applies).<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%3F\"><h3>Does it work with WooCommerce?<\/h3><\/dt>\n<dd><p>This version provides a payment button, the payment window and developer SDKs. A WooCommerce payment gateway isn't included yet. Developers can build one with the PHP and JavaScript SDKs.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.13<\/h4>\n\n<ul>\n<li>Fix: use the correct SablePay API endpoints (<code>https:\/\/api.sablepay.io\/api\/v1\/<\/code> and <code>https:\/\/sandbox-api.sablepay.io\/api\/v1\/<\/code>).<\/li>\n<\/ul>\n\n<h4>1.3.12<\/h4>\n\n<ul>\n<li>Initial release on WordPress.org.<\/li>\n<li>Payment window with QR code, live status tracking and expiry countdown.<\/li>\n<li><code>[sablepay_button]<\/code> shortcode.<\/li>\n<li>Secure REST proxy, so the API key never reaches the browser.<\/li>\n<li>JavaScript and PHP SDKs, with the same API as the SablePay Angular SDK.<\/li>\n<li>Settings screen with connection test, plus <code>wp-config.php<\/code> overrides.<\/li>\n<\/ul>","raw_excerpt":"Accept stablecoin payments (USDC, USDT and more) with a QR code payment window, live status tracking and a simple payment button shortcode.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/405853","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=405853"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/rahul153"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=405853"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=405853"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=405853"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=405853"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=405853"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=405853"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}