Developer documentation

Mainmoney payment links API

Sign in

Getting started

Getting started

Use the Developer dashboard to create a Sandbox or Live app and obtain client_id / client_secret. Mainmoney is your acquirer for card and mobile money — you integrate against our API only.

Base URLs

  • API: https://api.mainmoney.net/api/v2
  • OAuth token: POST /developers/oauth/token
  • Payment links: /developers/v1/payment-links
  • Terminal payments: /developers/v1/terminal-payments

Products

  1. Create an app in Apps & Credentials (optional per-app logo).
  2. Call GET /developers/v1/config to discover payment methods and sandbox test mode.
  3. Exchange credentials for a bearer token.
  4. POST /developers/v1/payment-links with amount, currencyCode, and required merchantReference.
  5. Send payers to the returned url.
  6. Verify completion via signed redirect query params, webhooks, or GET /developers/v1/payment-requests.

See Create a payment link.

Terminal payments (in-store CRM / POS)

  1. Same OAuth app credentials.
  2. GET /developers/v1/merchants then GET /developers/v1/terminals.
  3. POST /developers/v1/terminal-payments to push amount + currency to a signed-in terminal.
  4. Cashier completes palm / phone / QR / cash on the device.
  5. Receive terminal_payment.* webhooks with your merchantReference and metadata.

See Terminal payments quickstart.

Hands-on sample: Terminal payments demo (Express + ngrok webhooks).

Sandbox activity does not appear in the business ledger — only in the developer dashboard.

See Authentication and Sandbox testing.