BoomPay/docs
BoomPay Developer Hub

Checkout with BoomPay.
Ship it anywhere.

Complete integration code for 10 e-commerce platforms and12 PSP partners — plus the full API reference. Every sample is built directly from the BoomPay SDK source. Customers pay in their local currency. You receive in yours. Account-to-account settlement in under 3 seconds.

Checkout with BoomPayboom·market
customer pays₦ 4,200,000
currencyNGN → EUR
merchant receives€ 2,400
settlement< 3 seconds
methodAccount-to-account
PAID
API ReferenceGitHub: BoomDotMarket/BoomPay ↗npm: boom-pay-sdk ↗PSP Partner Docs →boom.market / BoomPay ↗

The opportunity

2 billion adults transact in cash outside the global banking system — $33 trillion circulating annually across 100+ currencies. They want to buy from your store. They cannot complete your checkout today. Every integration on this site fixes that.

2.2Bn
Adults outside banking
Cash-transacting customers who cannot complete an international online checkout today. Every storefront that adds BoomPay reaches them.
$33Tn
Annual cash economy
Circulating across 100+ currencies every year, invisible to every payment system that requires a card or a bank account. BoomPay captures it.
3s
Account-to-account settlement
Customer pays in local currency. Merchant receives in own currency. No card network. No clearing window. Confirmed in your wallet before the page refreshes.
60+
Countries already live
Africa, Middle East, South Asia, Latin America, and beyond. The infrastructure is built. The network is live. You add the checkout button.

How Checkout with BoomPay works

Every integration on this site — e-commerce plugin or PSP partnership — implements the same five-step lifecycle. One SDK call creates the payment. One middleware verifies the signed return. Learn this loop once and every platform page is just where those two calls live in that platform’s codebase.

01

Customer funds Boom wallet

The customer deposits local cash at a Boom hATM or partner location. No bank account required. Cash becomes instant digital purchasing power in their own currency.

02

Shops your store

The customer browses your storefront normally — your brand, your checkout, your environment. Nothing changes until they reach the payment step.

03

Checkout with BoomPay

The customer selects BoomPay at checkout. Your server calls payments.createIntent() with the amount, your success/failure URLs, and a label. The customer is redirected to BoomPay's hosted confirmation page.

04

Signed return

BoomPay redirects the customer back to your successUrl or failureUrl with paymentIntentId and X-Boom-Signature as query parameters. Your server verifies the HMAC-SHA1 signature.

05

Merchant receives instantly

Call getPayment() to confirm, mark the order paid, and your merchant wallet receives the settlement in your own currency — account-to-account, in under 3 seconds. Zero chargebacks. No FX risk.

E-commerce platform plugins

Drop-in plugins for the 10 most widely deployed e-commerce platforms. Native gateway frameworks (WooCommerce, Magento, PrestaShop, OpenCart) get a full plugin class. Hosted platforms (Shopify, BigCommerce, Wix, Ecwid, Squarespace) get the most direct integration the platform’s own API supports, documented honestly.

PSP partner integrations

One integration per PSP registers BoomPay as a payment option available to every merchant on that platform — no per-merchant SDK work. Covers the major gateway PSPs (Adyen, WorldPay, Atos/Worldline), wallet providers (PayPal, WeChat Pay, Alipay, Paytm, Amazon Pay), mobile money (M-Pesa), carrier billing (Fortumo), BNPL (Klarna), and crypto (BitPay). Full partner integration guide at psp/integration-guide.html.

Coming in 2027 — x402 Agentic Commerce

BoomPay will support the x402 protocol for machine-to-machine, autonomous agent payments. AI agents will be able to transact using BoomPay with a single API call and a cryptographic signature — no checkout form, no 2FA, no human in the loop. BoomPay is already positioned at the application layer of the emerging agent payments stack. Reference: agentpaymentsstack.com/boom.

x402 Protocol
Machine-to-machine payments
The emerging standard for agent-native commerce. BoomPay will implement x402 in 2027, enabling autonomous AI agents to pay via BoomPay without any human interaction.
Programmatic spend
Pre-authorised envelopes
Agents spend exactly what they are permitted — cryptographic spend envelopes, no checkout queue, no approval loop. Your catalogue stays open to machine buyers at machine speed.
Agent Payments Stack
The full infrastructure map of where BoomPay sits in the autonomous agent commerce ecosystem — from settlement layer to application-level agent commerce.

What’s in the SDK

Three things worth knowing before copying any code from this site.

npm: boom-pay-sdk
The correct package name is boom-pay-sdk (hyphenated) — the repo README incorrectly says boompay-sdk, which 404s on npm. Current version: 2.0.2. Every install command on this site uses the real name.Full API reference →
JS/TS only — PHP wrappers included
The official SDK is Node.js. For the PHP platforms (WooCommerce, Magento, PrestaShop, OpenCart), each plugin ships a small BoomPayClient class built from reading the SDK source — same two endpoints, same auth header, same HMAC signature scheme.
API key stays server-side
Every integration on this site creates payment intents from server-side code only. None of them expose the BoomPay API key to the browser. See thesecurity notes in the API reference for the full reasoning.