BoomPay Developer Hub

Checkout with BoomPay.
Ship it anywhere.

Complete integration code for 10 e-commerce platforms and 12 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.

Read the API reference SDK on GitHub ↗

Checkout with BoomPayboom·market

customer pays₦ 4,200,000

currencyNGN → EUR

merchant receives€ 2,400

settlement< 3 seconds

methodAccount-to-account

PAID

API Reference GitHub: 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.

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.

Shops your store

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

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.

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.

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.

WooCommerce PHP

Native payment gateway

A WC_Payment_Gateway plugin for any WordPress store.

Shopify Node

App + manual method

Express app wired to a manual payment method, plus the formal Offsite extension path.

Magento 2 PHP

Offsite payment module

An Adobe Commerce / Magento 2 module using the standard redirect-method pattern.

PrestaShop PHP

Payment module

A hookPaymentOptions module with redirect + callback controllers.

OpenCart PHP

Payment extension

A catalog/admin extension pair for OpenCart 4.x.

BigCommerce Node

Custom checkout button

Checkout + Orders API flow for an offsite payment button.

Wix Velo

Payment Provider SPI

A self-service service plugin written in Velo, no partner approval needed.

Squarespace Embed

Buy-button embed

A code-block embed backed by a small serverless function, since Squarespace has no gateway API.

Ecwid by Lightspeed Node

Payment API app

A registered payment app using Ecwid's encrypted order payload.

Custom Checkout / Stripe Node

Express middleware

Drop BoomPay in next to an existing Stripe Checkout as a second payment option.

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.

Add BoomPay as an Alternative Payment Method in WorldPay's order API.

PayPal / Braintree Wallet

Braintree Local Payments

Surface BoomPay through Braintree's Local Payment Methods framework.

Klarna BNPL

Payments API

Offer BoomPay as a pay-now option alongside Klarna's BNPL in one session.

Amazon Pay Wallet

Partner API

Present BoomPay alongside Amazon Pay as a parallel checkout option.

Atos / Worldline Gateway

Sips / Worldline API

Plug BoomPay into Worldline's SIPS APM framework as a redirect method.

BitPay Crypto

Invoice API

Add Boomcoin (BMC) alongside BitPay's existing cryptocurrency invoice flow.

WeChat Pay Wallet

Open Platform API

Expose BoomPay as an additional payment option in WeChat Pay merchant checkout.

Alipay Wallet

Global Partner API

Add BoomPay to Alipay's merchant payment method catalogue.

Paytm Wallet

Payment Gateway API

Integrate BoomPay as a parallel crypto option in Paytm's gateway checkout.

M-Pesa Mobile Money

Daraja API

Offer BoomPay alongside M-Pesa STK Push for merchants in mobile-money markets.

Fortumo Carrier

Payment API

Surface BoomPay as an alternative when carrier billing is unavailable.

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

agentpaymentsstack.com/boom

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 the security notes in the API reference for the full reasoning.

Checkout with BoomPay.Ship it anywhere.