Skip to main content

Changelog

Last updated: 2026-07-17

2026-07-17 — Merchant API documentation refresh​

This release refreshes the complete Merchant API integration journey while preserving established public documentation URLs.

  • Reorganized navigation around discovery, inbound pay-ins, outbound payouts, operations, reconciliation, and focused API references.
  • Added catalog-first method selection, Mobile Money Transfer guidance, and the complete approved public mobile-money alias/name catalog. Live account and environment availability still comes from discovery.
  • Clarified when hosted mobile money sends mobileMoneyOperator, plus current bank-transfer submethod, voucher, and method-specific request rules.
  • Added detailed Balance V2 position and history documentation, including country scope, bucket relationships, payout pre-checks, filters, ordering, movement correlation, and pagination.
  • Expanded PaymentOrder, test-method, failure-reason, lifecycle, payment-read, and late-correction guidance.
  • Corrected webhook acknowledgement/retry semantics and expanded raw-body HMAC signature verification and replay protection guidance.

Existing integrations should recheck Catalog and availability, Choose a payment flow, Balances, and Webhooks against their current request and reconciliation logic.

Earlier updates​

  • 2026-06-13 — Refreshed merchant swagger, clarified H2P Mobile Money operator handling during hosted checkout, and added merchant-reference payment lookup.
  • 2026-05-22 — Added mobileMoneyDetails.voucherPin, the Vouchers guide, refreshed merchant swagger host metadata, and clarified H2H detail validation, webhook idempotency, and late status corrections.
  • 2026-05-04 — Added mobile-money operator coverage and clarified catalog-first operator discovery for pay-ins and pay-outs.
  • 2026-05-02 — Added coverage, mobile-money, and operator-discovery guides for market planning and checkout setup.
  • 2026-05-01 — Added pay-in mobile-money operator discovery and clarified exact operator-code reuse.
  • 2026-04-28 — Added payment status simulation for non-production testing and account-name guidance for mobile-money payouts.
  • 2026-04-20 — Clarified catalog discovery, countryCode, validation errors, webhook retries, and Gambia and Malawi mobile-money examples.
  • 2026-04-18 — Added catalog-based market discovery and clarified multi-market currency handling, payout customerSegment, pay-in contact fields, and paymentUrl.
  • 2026-04-11 — Updated pay-in and pay-out request references and countryCode guidance.
  • 2026-04-03 — Clarified Tanzania mobile-money examples, operator discovery, and nested mobile-money validation fields.
  • 2026-04-02 — Added mobileMoneyOperator for H2P pay-ins and mobileMoneyDetails.operator for H2H mobile-money pay-ins.
  • 2026-03-05 — Clarified payment-method coverage, rejected methods, and discovery flow.
  • 2026-03-03 — Added request-context fields, payment-method detail guidance, and webhook idempotency guidance.
  • 2026-02-24 — Corrected query parameter casing, added balances, clarified webhook acknowledgements, key types, test method behavior, and payment status responses.