Zoe Pay API

Bearer key from Portal → Developers. Envelope is success / data / error. Refunds are operator-marked until OmniBsic reversal exists.

openapi.json Overview

openapi.json

openapi: 3.1.0
title: Zoe Pay API
paths: 9

MTN MoMo
Telecel Cash
AT Money
Visa
Mastercard

Machine copy at /api/v1/openapi.json

GH₵ 76.70

You keep

success, data, error
401 without a key. insufficient_scope when the Bearer is missing a grant.
Products, orders, payments
Refunds and balance. No /api/v1/customers in this spec.

Reference

Every v1 route

POST /api/v1/payments
Create a payment
payments:write
GET /api/v1/payments/{ref}
Read a payment
payments:read
POST /api/v1/checkout/intent
Create a popup checkout intent
payments:write
GET /api/v1/balance
Read available balance
balance:read
POST /api/v1/refunds
Request a refund (manual payout)
refunds:write
GET /api/v1/products
List products
products:read
POST /api/v1/products
Create a product
products:write
GET /api/v1/products/{id}
Read a product
products:read
GET /api/v1/orders
List orders
orders:read
GET /api/v1/orders/{ref}
Read an order
orders:read

Envelope

success, data, error. Nothing else

401 without a key. insufficient_scope when the Bearer is missing a grant.

Products, orders, payments, refunds, balance.
No /api/v1/customers in this spec.
Simulate header on writes that support it.

Overview

GH₵ 76.70

You keep

Invite only

A key still comes from Portal → Developers

This page is the map. Access is not self-serve.

Zoe Pay Request access

Instant MoMo
Available the same day.
3.5% + GH₵0.50
Free plan. No monthly fee.
No GH₵7
No extra withdrawal fee.

Around the spec

Embed, WordPress, terms

Overview

Join 1,200 on the waitlist

Showcase the work. Get paid on MoMo. Sell from one /@handle, send a portal invoice, run a membership, and track it all in one wallet. Free to start. One fee when a buyer pays.

Get Started