Malaleem API

Overview

Pay another Malaleem merchant from your Business Wallet, with the same API key as the gateway (`Authorization: Bearer <key_id>:<secret>`). The recipient is named by its six-digit **merchant code** (the code on its till and in its dashboard; the last digit is a check digit, so a typo is refused instead of paying a stranger). Built for platforms that collect money on merchants' behalf and settle with them — a courier operator paying restaurants the cash it collected on delivery. A **live** key moves real money at once: your Business Wallet in the transfer's currency is debited and the recipient's credited, in one database transaction, booked exactly once. A **test** key simulates: the recipient must exist, but no balance is read or moved and the transfer says `simulated: true`. No fee; no currency conversion (pay from the wallet in the currency you send). Confirm a code with `GET /api/v1/gateway/merchants/:code` before sending money.