Managed Disbursements

Managed Disbursements are an optional feature that can be enabled on your Tola Wallet API URL. Disbursements submitted as 'managed' can be repeatedly re-attempted from the Tola Wallet portal instead of being reported back to the Merchant as unsuccessful.

The mode applies to a certain type of Merchant who operates a transactional flow, where there is no account structure that can easily manage Disbursement retries or does not maintain a user-level balance where the funds can be returned.

When a successful Disbursement is completed the callback is issued to the Merchant.

In order to use Managed Disbursements you must request that the feature is enabled on your Tola Wallet API URL. Once enabled the managed boolean flag will be a mandatory parameter for all Disbursement requests.

In all other ways a Managed Disbursement is identical to a normal disbursement.

curl --request POST \
  --url https://apidocs.tolamobile.com/transaction \
  --header 'Authorization: ZGVtbzpwQDU1dzByZA==' \
  --header 'Content-Type: application/json' \
  --data '{
  "msisdn": "254000000001",
  "type": "disbursement",
  "channel": "KENYA.SAFARICOM",
  "currency": "KES",
  "amount": 100,
  "sourcereference": "8FD2KuZNJnBPLKmz",
  "managed": true
}'

HMAC Signing

Security