Skip to content

Choose your integration

Taking payments on your own web page? Use Embedded checkout. It takes every payment method, cards with 3-D Secure included, and card details never reach your servers.

The three paths differ in where the customer pays. Hosted checkout is the fastest to launch, and the Direct API is for places with no browser at all.

Hosted checkout

Use this if you want no payment UI to build. You redirect the customer to Pesepay’s page, and they come back when they have paid.

Embedded checkout

Use this if you have a web page or app and want the checkout to stay on it. You mount Pesepay Elements, and the customer pays in them.

Direct API

Use this if there is no browser: USSD, WhatsApp bots, POS terminals, kiosks or charges your server starts. You build the UI yourself.

Hosted checkoutEmbedded checkoutDirect API
Where the customer paysPesepay’s pageYour page, in Pesepay ElementsYour own UI and fields
Server workCreate the paymentCreate the paymentCreate and charge in one encrypted call
Browser workRedirectMount an elementEverything: form, validation, waiting
Payment methodsAllAllEcoCash, InnBucks, O’mari, PayGo
Cards and 3-D SecureYesYes, in a Pesepay-hosted frameNo
Mobile money approval waitHandledHandled in the elementYou poll or wait for the callback
FrameworksAnyScript tag, JavaScript, React, Vue, AngularAny server language
Best forFastest launch, no front endWeb shops and apps with their own checkoutUSSD, bots, POS, kiosks, server-started charges

Already on the Direct API and want cards or more methods? See Migrate from the Direct API.

Only the middle step differs. Your keys, creating the payment, the referenceNumber, transaction statuses, the result callback and testing work the same way on all three paths, so you learn them once. See How payments work.