Integration tools

API playground, integration PDF, OpenAPI, Postman, and AI skill files — everything you need to integrate MarzPay faster.

API playground

Explore and call every merchant endpoint in your browser — collections, disbursements, balance, webhooks, and more. Uses the same OpenAPI spec as the downloads below.

Open API playground

Integration guide (PDF)

A complete, printable integration manual — authentication, every merchant API product, webhooks, error codes, go-live checklist, and code examples. Also covers mobile app, WhatsApp, and USSD (no channel API details).

Download integration guide (PDF)

OpenAPI & Postman

Machine-readable API spec and a ready-to-run Postman collection for every merchant endpoint — collections, disbursements, bank transfer, bills, airtime, and more.

Open API playground Download OpenAPI (YAML) Download Postman collection

API playground: Interactive docs for every endpoint — enter your API key and secret, send requests, and see live responses.

OpenAPI: Import into Swagger UI, Insomnia, or SDK generators. Server URL is pre-filled for this environment.

Postman: Import the JSON file → set collection variables apiKey and apiSecret → send requests (Basic Auth is configured on the collection).

marzpay-integration skill

Full reference for every MarzPay product — collections, card, disbursements, bank transfer, bills, airtime/data, phone verification, webhooks, and more.

Download SKILL.md Download ZIP (Cursor folder)

AI assistants (Cursor, Claude, ChatGPT)

Cursor (recommended)

  1. Download the ZIP above and extract it.
  2. Copy the marzpay-integration folder into your project at .cursor/skills/
  3. Final path: .cursor/skills/marzpay-integration/SKILL.md
  4. In Cursor, ask: "Integrate MarzPay collections and webhooks in this app" — the agent will follow the skill automatically.

Claude / ChatGPT / other AI

  1. Download SKILL.md.
  2. Upload it as project knowledge, or paste its contents into the chat.
  3. Add your stack and goal, for example:
Use the attached MarzPay skill. Integrate collect-money and webhooks in my Laravel app.
API base: https://wallet.wearemarz.com/api/v1
I already have API keys in .env.

Copy the starter prompt

No download needed — paste this into any AI assistant along with a link to these docs.

Integrate MarzPay payment API.

Docs: https://wallet.wearemarz.com/documentation
API base: https://wallet.wearemarz.com/api/v1
Auth: HTTP Basic (api_key:api_secret as base64)

Build:
1. POST /collect-money — mobile money collections (UUID reference, country UG)
2. POST /send-money — disbursements (if needed)
3. Webhook handler for callback_url (idempotent, return 200)
4. Env vars for credentials — never hardcode

Stack: [your framework here]
Use sandbox first if account is in sandbox mode.

What's in the skill file?

  • All products: collections, card payments, send money, bank transfer, bill payments (LIGHT/NWSC/DSTV/GOTV), airtime & data, phone verification
  • Balance, transactions, services, and webhook management
  • Payment links (dashboard), WhatsApp & USSD channel overview
  • Authentication, wallets (main + card), IP whitelist, subscriptions
  • Request/response examples for every product
  • Error codes (VALIDATION_ERROR, DUPLICATE_REFERENCE, etc.)
  • Node.js, PHP, and Python snippets + integration checklist

Full human-readable docs: API playground, Getting Started, Changelog, Collections, Send Money, Webhooks.

Chat on WhatsApp