MagicPayments Integration Guides
Practical, copy-paste walkthroughs for connecting a merchant to MagicPayments — one page per gate and method, each covering both a pay-in and a pay-out end to end. New gates are added here as they launch.
Start with Getting started. It covers authentication, request signing, money units, and the status/callback lifecycle that every guide below builds on. Each page then focuses only on what is specific to that gate.
Start here
Getting started
Authentication, request signing, money units, and the payment lifecycle every integration on this site shares. Read this first.
Error handling
Why a request is refused, why an accepted payment still fails, and how to tell the two apart — HTTP statuses, error codes, and what to retry.
Gate (hosted) integrations
Madagascar P2P Gate
Accept mobile-money pay-ins on a MagicPayments-hosted page and send mobile-money payouts in Malagasy Ariary (MGA).
South Korea P2P Gate
Accept bank-transfer pay-ins on a hosted page and send bank-account payouts in South Korean Won (KRW).
Nepal P2P Gate
Accept eSewa wallet pay-ins on a hosted page and send eSewa payouts in Nepalese Rupee (NPR).
Brazil Pix Gate
Accept Pix pay-ins on a hosted QR page and send Pix payouts to a CPF key in Brazilian Real (BRL).
Pakistan P2C Gate
Accept JazzCash and Easypaisa wallet pay-ins on a MagicPayments-hosted page in Pakistani Rupee (PKR). Pay-in only — this method does not support payouts.
Mongolia Bank Transfer Gate
Accept bank-transfer pay-ins on a hosted page that shows the recipient IBAN, and send bank-account payouts in Mongolian Tugrik (MNT).
Moldova MIA Gate
Accept MIA instant bank pay-ins in Moldovan Leu (MDL) — the payer is redirected and approves in their banking app. Pay-in only.
Rwanda Mobile Money Gate
Accept Airtel Money and MTN MoMo pay-ins on a hosted page where the payer approves a push on their phone, and send mobile-money payouts in Rwandan Franc (RWF).
Togo Mobile Money Gate
Accept Moov Money (Flooz) and Mixx by Yas pay-ins on a hosted page where the payer approves a push on their phone, and send mobile-money payouts in West African CFA Franc (XOF).
General Card Gate
Accept card pay-ins on the MagicPayments hosted card form (no PCI scope on your side) and send card payouts.
Host-to-host (H2H) integrations
How these pages are organised
Every gate guide follows the same shape so you always know where to look:
- When to use it — the rails, currency, and operations the gate supports.
- Prerequisites — the IDs and credentials you need from your account manager.
- Pay-in — the full request, the response, and how to track the result.
- Pay-out — the destination shape specific to this gate, plus tracking.
- Testing & go-live — sandbox notes and the production checklist.