WooCommerce plugin
Drop a PHP file into your WordPress site. Checkout customers see "Pay with crypto (SorenPay)" alongside your other payment methods.
In sandbox today
Checkout runs with test money, and payments are recorded in your SorenPay ledger as a stablecoin credit that can't be spent or withdrawn yet.
Install
- Ask support@sorenpay.com for
sorenpay-woocommerce.php(it isn't published for download yet) - WordPress admin → Plugins → Add new → Upload plugin → select the file
- Activate
- WooCommerce → Settings → Payments → SorenPay
- Tick "Enable SorenPay" → paste your
apk_…key from Developers → API keys - (Recommended) Configure the outbound webhook (next section)
Webhook configuration
In the SorenPay plugin settings, the Webhook URL is shown. Copy it.
Then:
- Email support@sorenpay.com with that URL and ask for the
checkout.session.completedevent (self-serve endpoints are coming) - We send you the endpoint's signing secret
- Paste it into the plugin's "Webhook signing secret" field
The plugin verifies HMAC signatures on every webhook before marking orders paid.
How it works
| Step | Where |
|---|---|
| Customer hits Checkout | WooCommerce |
| Picks "SorenPay" payment method | WC checkout page |
process_payment() calls POST /api/v1/checkout/sessions with the order total + merchantReference: wc-order-<id> | WC plugin |
| Customer redirected to hosted SorenPay page | sorenpay.com |
| Customer picks asset/chain, pays from wallet | sorenpay.com |
On-chain confirmation → checkout.session.completed webhook | sorenpay.com → your WC store |
handle_webhook() marks the order paid | WC plugin |
Requirements
- WordPress + WooCommerce ≥ 7.0
- PHP ≥ 8.0
- A SorenPay workspace +
apk_key
Sandbox
Every workspace is in sandbox today. To complete an order without a real
blockchain payment, use Simulate a test payment on the dashboard's
Checkout page, or POST /api/v1/checkout/sessions/{id}/simulate.
License
The plugin file is licensed under Apache-2.0.
Coming next
Refunds aren't built: there's no refund endpoint yet.