Mojo Payments API

The Mojo Payments API lets your own software, such as your accounting package or ERP, work with your Mojo Payments account without anyone signing in to the portal.

You are	You can
A merchant	Create and send invoices and see them paid, read your deposits line by line for your books, read your card payments, locations and MIDs.
A reseller partner	Read the merchants in your portfolio and the merchant applications submitted through you.

Point-of-sale systems taking card-present payments use a different API: the POS Gateway API.

The basics

Address: every request goes to https://api.paymentsmojo.com, over HTTPS.
JSON in and out (Requests and responses).
Authentication: an API key, exchanged for a token that lasts 10 minutes.
Lists come a page at a time (Pagination).
Errors explain themselves in plain words (Errors).

Quick start

Create an API key

In the portal, an Owner or Admin opens Settings → API keys, names the key, ticks what it can do and selects Create key. Copy the key id and secret: the secret is shown only once.

Get a token

curl https://api.paymentsmojo.com/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=mk_… \
  -d client_secret=ms_…

{ "access_token": "eyJ…", "token_type": "Bearer", "expires_in": 600, "scope": "payments.view", "organization_id": "0b8f…" }

Call the API

curl https://api.paymentsmojo.com/payment-requests?status=Open \
  -H "Authorization: Bearer eyJ…"

Authentication: keys, tokens and permissions.
Invoices, Deposits, Payments and locations and Reseller portfolio: what each part of the API is for.
The API reference lists every endpoint, its fields and its answers, and lets you try them.

Get started

Using the API

Guides

API reference

The basics

Quick start

Next

​The basics

​Quick start

​Next

The basics

Quick start

Next