mzapayments

Guides

Integration guides

Opinionated paths that mirror how production merchants wire mzapayments into carts and billing systems.

Issue your first invoice

  1. Create a SANDBOX API key in the dashboard.
  2. POST /api/v1/invoices with orderId, amountDue, and currency.
  3. Fetch checkout details via /api/checkout/{invoiceId}.
  4. Simulate payment using the sandbox tools.

Payment links without code

  1. Create a link in the dashboard or via POST /api/v1/payment-links.
  2. Share the slug URL with your customer.
  3. Monitor payments in the dashboard or via GET /api/v1/payments.

Webhooks you can trust

  1. Register an HTTPS endpoint with POST /api/v1/webhooks.
  2. Store the signing secret securely.
  3. Verify signatures before updating order state.
  4. Use the dashboard test delivery button to validate handlers.

Need the raw reference? Visit Swagger UI or the API overview.