CSV Formats

The Disbursement API supports two distinct formats for the uploaded vouchers.csv file, allowing you to seamlessly issue standard mobile vouchers or physical/virtual Card PANs. The platform automatically detects the mode based on the content of the file.

1. Standard Vouchers Format

This is the default mode used for distributing standard digital vouchers to end-users via SMS/Email.

Name	Requirement	Description
MSISDN	Required	The recipient’s cellphone number (e.g. 27820000000).
IDNumber	Optional	The recipient’s ID number (used if CheckIDCellMatch is true).
Amount	Required	The value of the voucher to issue in cents (e.g. 5000 for R50.00). Must be greater than 0.
VoucherType	Required	The identifier of the voucher type to issue (e.g. 168Cash).

Example vouchers.csv

MSISDN,IDNumber,Amount,VoucherType
27820000000,9901015000000,5000,168Cash
27821111111,,10000,Food

2. Card PANs Format

This mode is designed for bulk-issuing and funding physical or virtual cards. The engine will automatically distribute funds to existing cards or virally issue new cards on the fly.

To trigger this mode, the first column must contain either a valid 13-digit Card PAN, or the special keyword *AUTO* which tells the system to automatically generate a brand new card.

Name	Requirement	Description
CardPAN	Required	A specific Card PAN to top-up, or *AUTO* to virally generate a new card.
Amount	Required	The value to fund the card in cents. Can be 0 if issuing a new unlinked card (with *AUTO*).
VoucherType	Optional	The voucher type to assign to the card. Required if CardPAN is *AUTO*.
Username	Optional	The MSISDN of the user to link the card to. Leave empty with a 0 amount to create floating, unlinked cards.

Example vouchers.csv

CardPAN,Amount,VoucherType,Username
5003456789012,5000,,
*AUTO*,10000,168Cash,27820000000
*AUTO*,0,GiftCard,