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

Reference for collections, card, disbursements, bank transfer, bills, airtime/data, phone verification, and webhooks.

Download SKILL.md Download ZIP

Using the skill with coding assistants

Cursor

  1. Download the ZIP and extract it.
  2. Copy the marzpay-integration folder into .cursor/skills/
  3. Path should be .cursor/skills/marzpay-integration/SKILL.md
  4. Ask your assistant to integrate MarzPay collections and webhooks using the project skill.

Other assistants

  1. Download SKILL.md.
  2. Add it as project knowledge, or paste it into the conversation.
  3. Include your stack and integration 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/KE/RW/CD; optional currency for DRC; optional metadata)
2. POST /send-money — disbursements (if needed)
3. Webhook handler for callback_url (idempotent, return 200; echo metadata if sent)
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 API, 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