Malaleem API

Tool: create_transfer

Pay another merchant from your Business Wallet — the same transfer as `POST /api/v1/gateway/transfers` — and return the transfer object `{id: "tr_…", status, direction, amount, currency, mode, simulated, reference, description, metadata, sender, recipient, created_at}`. Arguments: `idempotency_key` (string, required, max 255), `recipient_merchant_code` (six digits, required), `amount` (integer minor units, required), `currency` (ISO-4217, required), and optionally `reference`, `description`, `metadata` (object). A live key moves real money; a test key simulates. A retry with the same `idempotency_key` returns the first transfer; the same key with a different amount, currency, recipient or reference is refused. A refusal at money time (insufficient_funds, identity_verification_required, wallet_frozen) answers `isError: true` naming the failed transfer it recorded.