Skip to main content
POST
Quote the fees on a transfer

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Body

application/json
direction
enum<string>
required

Which way the money moves: payout to pay a beneficiary, collection to take money in. The two are priced differently.

Available options:
payout,
collection
Example:

"payout"

rail
enum<string>
required

The path the transfer takes. Pricing depends only on this, never on the institution — every bank costs the same, as does every mobile-money operator.

Available options:
momo,
bank
Example:

"momo"

amount_mwk
required

What the transfer would move. Either a JSON integer of whole kwacha, or an exact decimal string with up to 2 decimal places ("1000.55"). Fees are quoted on top of it. Must be positive and no greater than 1000000000000 MWK.

Example:

50000

Response

The quote.

currency
enum<string>
required
Available options:
MWK
amount_mwk
string
required

The amount quoted against, echoed back — exact decimal string.

Example:

"10000.00"

direction
enum<string>
required
Available options:
payout,
collection
rail
enum<string>
required
Available options:
bank,
momo
fees
object
required
total_fee
string
required

Every line above, summed. Always equal to their sum.

Example:

"329.00"

total_debit
string | null
required

Payouts only: the amount plus the total fee — the full cost of the transfer. Your beneficiary still receives the full amount. Null on a collection.

Example:

"10329.00"

amount_received
string | null
required

Collections only: the amount less the total fee — what you are credited. Negative if the fee exceeds the transfer. Null on a payout. (Shown here for a 10,000 collection, whose fee is 150.00 — a collection carries no flat fee, no VAT and no levy.)

Example:

"9850.00"