Preview Lipa Namba Payout
Validates a Lipa Namba or TanQR payout and returns the fee, balance, and beneficiary name.
lipaNamba + providerCode, or TanQR qrCode. Preview must resolve a beneficiary name before you create the payout.Authorizations
Authorization header containing the JWT access token returned from the generate token endpoint. The token already includes the Bearer prefix. Example: Authorization: Bearer eyJhbGciOi...
Body
Your payout amount
Account currency to pay out from (TZS or USD). Recipient receives TZS.
TZS, USD Your unique Order reference
Recipient Lipa Namba (merchant code). Required if qrCode is not sent. Do not send with qrCode.
"48001268"
Required when lipaNamba is provided. Use a providerCode from Retrieve Lipa Namba Providers.
"503"
Full TanQR string. Must include tz.go.bot.tips. Required if lipaNamba is not sent. Do not send with lipaNamba.
If enabled, this is the generated checksum of the payload. Refer to the documentation for more details.
Response
Lipa Namba payout preview response
Total amount to be deducted from your account balance (includes fee)
10100
250000
"Vodacom M-Pesa"
Transaction fee deducted from source currency (included in amount)
100
Indicates if currency conversion was applied (true when source currency differs from receiving currency)
true
Exchange rate details (only present when exchanged is true)
merchant, both, customer "merchant"

