Interface: DisbursePayload

Defined in: packages/pesa/src/types/disbursement.ts:36

Payload for sending a disbursement (B2C / wallet-out).

Pass this to PesaInstance.disburse to send money to a customer's mobile money wallet or bank account.

Mobile money — provide recipient.phone. Bank payout — provide recipient.accountNumber + recipient.bic.

Since

0.1.0 (mobile money), 0.2.0 (bank payout fields)

Properties

PropertyTypeDescriptionDefined in
amountnumberAmount in whole TZS. Must be > 0.packages/pesa/src/types/disbursement.ts:38
currencyCurrencyCurrency code. Currently only 'TZS'.packages/pesa/src/types/disbursement.ts:40
recipient{ accountNumber?: string; bic?: string; name?: string; network?: MobileNetwork; phone?: string; transferType?: BankTransferType; }Recipient details.packages/pesa/src/types/disbursement.ts:42
recipient.accountNumber?stringBank account number (for bank payouts).packages/pesa/src/types/disbursement.ts:50
recipient.bic?stringBank identifier code — fetch via getBanks() on supported providers.packages/pesa/src/types/disbursement.ts:52
recipient.name?stringRecipient's full name (optional but recommended).packages/pesa/src/types/disbursement.ts:46
recipient.network?MobileNetworkTarget mobile money network.packages/pesa/src/types/disbursement.ts:48
recipient.phone?stringMobile money phone number in MSISDN format: 255XXXXXXXXX.packages/pesa/src/types/disbursement.ts:44
recipient.transferType?BankTransferTypeTransfer type for bank payouts: "ACH" (default) or "RTGS".packages/pesa/src/types/disbursement.ts:54
referencestringYour internal reference. Must be unique.packages/pesa/src/types/disbursement.ts:57
remarks?stringOptional remarks / narration for the payout.packages/pesa/src/types/disbursement.ts:59

On this page