Changes
Every change to the API, the test environment and the integrations, before it reaches Mainnet. Follow it with the RSS feed.
Subscribe to the RSS feed in any feed reader, or check this page. Every change to the API, the test environment and the integrations is listed here before it reaches Mainnet. Changes you must act on are also emailed to the partners they affect.
Follow changes
Feed address: https://p2flux.com/docs/changes.xml. Service status and outages are on the status page.
WHMCS: P2Flux Gateway for WHMCS by Provonic
WHMCS hosts can take USDC on Base with the P2Flux Gateway for WHMCS by Provonic, a paid module built, sold and supported by Provonic: invoice payments and automatic renewals for recurring services, confirmed on the server. See WHMCS.
Finance-ready release: live on Mainnet since 4 November
Live on Mainnet since Wednesday 4 November. SDKs: JavaScript and PHP 0.15.0, Laravel 0.6.0, WooCommerce 1.3.0, Blesta 1.1.0, checkout 1.4.0.
On Tuesday 3 November the test API (api-test.p2flux.com, Base Sepolia) gets the next release. It runs there at least 24 hours before Mainnet, so you can test with your staging system first. Mainnet follows no earlier than Wednesday 4 November; this entry says when it is live. A short restart of the test API is possible during the update.
Everything is additive: no field, endpoint or error code is removed or renamed, and existing integrations and older SDK versions keep working. New:
- Your own reference (merchant_ref, e.g. an invoice number) when creating payments, links and subscriptions; it comes back in verify answers and webhooks.
- Signed webhooks: every notification carries a p2flux-signature header (Ed25519). Checking it is optional; the public key is in /v1/capabilities.
- Webhook delivery history and “retry now” through the API.
- Accounting statement of a wallet’s payments read from the chain, CSV for Xero and QuickBooks, with EUR and GBP values at the ECB reference rate (/v1/rates).
- Higher limits for requests signed by a merchant wallet (server side only).
- Refunds from a Safe: a support wallet can refund from your Safe within a daily limit set with Safe’s AllowanceModule.
- The payment link form says before sending that subscription links need at least 1 USDC per period.
Your webhook handler must accept JSON fields it does not know. A handler that refuses unknown fields would start answering 4xx after this release.
Private payments with Hinkal on Mainnet
Buyers can pay from a Hinkal shielded balance on Base Mainnet. The button appears only for merchants who turn it on. A private payment cannot be refunded through P2Flux, because the paying wallet is hidden. See Hinkal.
Return address and checkout address on payments
Payments can carry a return_url that the checkout offers after paying, and the API answers with a ready checkout_url. SDKs: JavaScript and PHP 0.13.0, Laravel 0.5.1.
Webhooks on Mainnet
P2Flux can notify your server when a payment is paid. A notification is a hint: verifying the payment with the API stays the main check. See Webhooks.