# Hermes

> USDT→MWK payouts: Quick, Cheap & Reliable .

- [Introduction](https://docs.jenzy.com/introduction.md): Pay Malawian kwacha to banks and mobile money from a prefunded balance.
- [Quickstart](https://docs.jenzy.com/quickstart.md): From an API key to a confirmed payout, in five calls.
- [Authentication](https://docs.jenzy.com/authentication.md): Bearer API keys, key rotation, IP allowlists, and rate limits.
- [Test in the sandbox](https://docs.jenzy.com/testing.md): Build and test your integration with test money, on a separate environment.
- [Go live](https://docs.jenzy.com/going-live.md): Move your integration from the sandbox to production.
- [Pay-ins](https://docs.jenzy.com/pay-ins.md): Money sent to your account number becomes a collection, costs one percentage fee, and credits your balance.
- [Payouts](https://docs.jenzy.com/payouts.md): Draw your balance down to a Malawian bank account or mobile money number.
- [Test accounts](https://docs.jenzy.com/test-accounts.md): Sandbox bank accounts and mobile wallets you can pay out to.
- [Webhooks](https://docs.jenzy.com/webhooks.md): The event list, the delivery rules, and how to verify a signature.
- [Errors](https://docs.jenzy.com/errors.md): Each stable error code: its meaning, its HTTP status, and when to send the request again.
- [Maintenance and outages](https://docs.jenzy.com/maintenance-and-outages.md): How your system must operate when Jenzy stops the API.
- [Agent skill](https://docs.jenzy.com/agent-skill.md): Give your agent the full integration. Install it one time, and the agent obeys the rules of this API.
- [Ping](https://docs.jenzy.com/api-reference/ping.md): The auth tracer for `/v2`: exercises the full key → org → allowlist → rate-limit chain and echoes who you are. Still answers when the `/v2` shutter is closed — `status` is `maintenance` or `outage` then, and every other `/v2` route returns 503.
- [Get balance](https://docs.jenzy.com/api-reference/get-balance.md): Your ledger balance — available to draw down vs held by in-flight payouts. Unsettled trades and in-flight holds are exactly the difference from your raw wallet.
- [List institutions](https://docs.jenzy.com/api-reference/list-institutions.md): Where a `bank` or `momo` payout in this asset can go. Pick an `institution_id` here and pass it in the payout `destination`; `type` tells you which destination shape to send.
- [List payouts](https://docs.jenzy.com/api-reference/list-payouts.md): Your payouts, newest first, optionally filtered by `asset` and `status`. Pass `next_before_id` back as `before_id` for the next page; null means done.
- [Get a payout](https://docs.jenzy.com/api-reference/get-a-payout.md): One payout by id — the polling read for a payout you created.
- [Create a bank payout](https://docs.jenzy.com/api-reference/create-a-bank-payout.md): Hold funds and queue a payout to a bank account. The endpoint is the rail — there is no rail field in the body. Requires an Idempotency-Key.
- [Create a mobile money payout](https://docs.jenzy.com/api-reference/create-a-mobile-money-payout.md): Hold funds and queue a payout to a mobile money number. The endpoint is the rail — there is no rail field in the body. Requires an Idempotency-Key.
- [Quote the fees on a transfer](https://docs.jenzy.com/api-reference/quote-the-fees-on-a-transfer.md): What a transfer would cost, before you make it. Priced from fee schedule, so the same transfer is always quoted the same amount for you, so this is the figure to check against rather than a percentage from the docs. It is not a commitment and reserves nothing.
- [List collections](https://docs.jenzy.com/api-reference/list-collections.md): Money that landed on your balance — bank and paybill pay-ins to your virtual accounts and stablecoin transfers to your deposit addresses — newest first. `amount` is what was credited: there is no separate fee line. Filter with `asset`; pass `next_before_id` back as `before_id` for the next page.
- [Get a collection](https://docs.jenzy.com/api-reference/get-a-collection.md): One collection by id.
- [Simulate a pay-in (sandbox only)](https://docs.jenzy.com/api-reference/simulate-a-pay-in-sandbox-only.md): Fund your sandbox balance by pretending a customer paid you. Sandbox only — in production this returns `403 sandbox_only`, because real money can only arrive by being sent to your account number.
- [Introduction](https://docs.jenzy.com/v2/introduction.md): One API for many assets. Hold, convert, and pay out from a balance in each asset that Jenzy enables for you.
- [Quickstart](https://docs.jenzy.com/v2/quickstart.md): Read your assets and balances, find where to send money, send a payout, and convert.
- [Sandbox](https://docs.jenzy.com/v2/sandbox.md): Build and test against the Multi-asset API with test money. What the sandbox can show you, and what it cannot.
- [Balances](https://docs.jenzy.com/v2/balances.md): One balance for each asset. Available, held, and shortfall, with no total.
- [Payouts](https://docs.jenzy.com/v2/payouts.md): One endpoint pays a bank account, a mobile money number, or a wallet address, in any enabled asset.
- [Conversions](https://docs.jenzy.com/v2/conversions.md): Move money from one of your balances to another. Get a quote, then execute it.
- [Collections](https://docs.jenzy.com/v2/collections.md): Money that arrives on one of your balances is a collection. Where to send it, and what you see.
- [Orders](https://docs.jenzy.com/v2/orders.md): Change a stablecoin into a local currency for a bank account, or buy a stablecoin with a bank transfer. Get a quote, then create the order.
- [Errors](https://docs.jenzy.com/v2/errors.md): The error codes that are new on the Multi-asset API, with the shared wrapper.
- [Webhooks](https://docs.jenzy.com/webhooks.md): The event list, the delivery rules, and how to verify a signature.
- [Authentication](https://docs.jenzy.com/authentication.md): Bearer API keys, key rotation, IP allowlists, and rate limits.
- [Maintenance and outages](https://docs.jenzy.com/maintenance-and-outages.md): How your system must operate when Jenzy stops the API.
- [Ping](https://docs.jenzy.com/api-reference/ping.md): The auth tracer for `/v2`: exercises the full key → org → allowlist → rate-limit chain and echoes who you are. Still answers when the `/v2` shutter is closed — `status` is `maintenance` or `outage` then, and every other `/v2` route returns 503.
- [List assets](https://docs.jenzy.com/api-reference/list-assets.md): The assets enabled for your organization, each with the decimals amounts carry on the wire and the operations you may run in it. An asset absent here does not exist for you: a payout, conversion or balance read in it is refused. The list grows as Jenzy enables corridors for you; the shape never chan…
- [List balances](https://docs.jenzy.com/api-reference/list-balances.md): Your ledger balance in every enabled asset, and in every other asset that holds money for you — one row each, with what is available to spend, what in-flight payouts hold, and any fee shortfall. An asset you have never used reads zero. There is no total: assets are not summed into a reference curren…
- [Get a balance](https://docs.jenzy.com/api-reference/get-a-balance.md): Your ledger balance in one enabled asset, or in one asset that holds money for you.
- [List institutions](https://docs.jenzy.com/api-reference/list-institutions.md): Where a `bank` or `momo` payout in this asset can go. Pick an `institution_id` here and pass it in the payout `destination`; `type` tells you which destination shape to send.
- [Create a payout](https://docs.jenzy.com/api-reference/create-a-payout.md): Reserve the money and pay a beneficiary in `asset`. `amount` is what they receive; your `source_asset` balance is debited `source_amount` plus `fee`. The destination is validated before any money is reserved, so a refusal (422) leaves nothing behind. The response is the payout as it stands after the…
- [List payouts](https://docs.jenzy.com/api-reference/list-payouts.md): Your payouts, newest first, optionally filtered by `asset` and `status`. Pass `next_before_id` back as `before_id` for the next page; null means done.
- [Get a payout](https://docs.jenzy.com/api-reference/get-a-payout.md): One payout by id — the polling read for a payout you created.
- [Quote a conversion](https://docs.jenzy.com/api-reference/quote-a-conversion.md): Price a conversion between a fiat asset and a stablecoin, in either direction. Fiat to fiat and stablecoin to stablecoin are not supported and get `unsupported_pair` (422). You fix `from_amount`; `to_amount` is exactly what you will receive if you execute before `expires_at`. A quote reserves no bal…
- [Execute a conversion](https://docs.jenzy.com/api-reference/execute-a-conversion.md): Consume a quote. A conversion is always fiat to stablecoin or stablecoin to fiat; the quote already fixed the pair. Your `from_asset` balance is checked now, not at quote time. The call normally returns a terminal `completed` or `failed`; a rare `processing` means the outcome is not yet known — poll…
- [List conversions](https://docs.jenzy.com/api-reference/list-conversions.md): Your conversions, newest first. Pass `next_before_id` back as `before_id` for the next page; null means done. `asset` keeps conversions into OR out of that asset.
- [Get a conversion](https://docs.jenzy.com/api-reference/get-a-conversion.md)
- [List collections](https://docs.jenzy.com/api-reference/list-collections.md): Money that landed on your balance — bank and paybill pay-ins to your virtual accounts and stablecoin transfers to your deposit addresses — newest first. `amount` is what was credited: there is no separate fee line. Filter with `asset`; pass `next_before_id` back as `before_id` for the next page.
- [Get a collection](https://docs.jenzy.com/api-reference/get-a-collection.md): One collection by id.
- [List virtual accounts](https://docs.jenzy.com/api-reference/list-virtual-accounts.md): Where a payer sends fiat to fund your balance in this asset: the bank account Jenzy holds for you, and where the asset has one, the mobile-money paybill. Read-only — Jenzy enables collections in an asset for you; ask if the list is empty. Bank pay-ins carry no payer identity, so tell your payer to k…
- [Get a deposit address](https://docs.jenzy.com/api-reference/get-a-deposit-address.md): Your static address for receiving stablecoins on a network. The first call issues it; every later call for the same network returns the same address, so no `Idempotency-Key` is needed. A transfer below 1 USDT or 1 USDC is lost — it is never credited and never appears as a collection.
- [List deposit addresses](https://docs.jenzy.com/api-reference/list-deposit-addresses.md): Every deposit address issued to your organization, one per network.
- [Simulate a collection (sandbox only)](https://docs.jenzy.com/api-reference/simulate-a-collection-sandbox-only.md): Sandbox only: lands `amount` of `asset` on your balance as test money. Answers `202` at once; the money credits in about a minute through the ordinary collection path, so poll `GET /v2/collections` for it. No `Idempotency-Key`: a duplicate is just more test money. In every other environment this rou…
- [List desk corridors](https://docs.jenzy.com/api-reference/list-desk-corridors.md): The currencies the desk trades against stablecoins, with the current all-in rate in each direction and the minimum order. A null rate means that direction is closed right now; `open` false means no quote can be taken. Rates hold until Jenzy replaces them.
- [Quote a desk order](https://docs.jenzy.com/api-reference/quote-a-desk-order.md): Pin a rate for one order. One side is a stablecoin and the other a corridor currency; the stablecoin side decides the direction (stablecoin → currency is a to-bank order paid to a beneficiary; currency → stablecoin is a from-bank order credited to your balance). Fix either amount; the other is deriv…
- [Create a desk order](https://docs.jenzy.com/api-reference/create-a-desk-order.md): Consume a quote. A to-bank order needs a `beneficiary` and holds `from_amount` of your stablecoin balance at once; the response is `accepted`. A from-bank order takes no beneficiary and holds nothing; the response is `awaiting_instructions` — wait for `order.awaiting_funds`, then wire `funding.amoun…
- [List orders](https://docs.jenzy.com/api-reference/list-orders.md): Your orders, newest first, optionally filtered by `asset` (either side) and `status`. Pass `next_before_id` back as `before_id` for the next page; null means done.
- [Get an order](https://docs.jenzy.com/api-reference/get-an-order.md): One order by id — the polling read for an order you created.
- [Upload a funding proof](https://docs.jenzy.com/api-reference/upload-a-funding-proof.md): From-bank orders only, while the order is `awaiting_funds`: send the file that shows your transfer to `funding.account_number` as the raw request body with its `Content-Type`. Jenzy checks the bytes are a PDF, JPEG or PNG and moves the order to `proof_submitted`. If the desk rejects the proof, `orde…
- [Download a funding proof](https://docs.jenzy.com/api-reference/download-a-funding-proof.md): A short-lived link to the newest funding proof you uploaded on this order. The URL is valid until `expires_at` (about five minutes); call again for a fresh one.

## OpenAPI Specs

- [openapi](/openapi.json)
- [openapi](/v2/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.