Skip to main content
Release Date: 03/09/2025

​
Overview

This release includes updates on external references within the Payouts API and changes to TZS transaction limits.

​
1. Unique Third-Party Reference Check

You can now include flags in your disbursement request to prevent processing duplicate payouts based on third_party_reference_1 and third_party_reference_2. To enable this check, set the following fields to true 1: 
{
    "is_third_party_reference_1_unique": 1,
    "is_third_party_reference_2_unique": 1
}
When these fields are set to true(1), any payout request with duplicate third-party references will be rejected. If the flags are not included, the transaction will proceed as normal. These fields are optional and can help improve the safety and integrity of your payouts. Sample Disbursement Request with Duplicate Third-Party Reference 
{
    "client_id": "Axxxxxxxxxxxxxxxxxxxxxxxxxxxxxz",
    "salt": "justrandomstring",
    "sender": "John.co",
    "timestamp": xxxxxxxxx,
    "signature": "2193dxxxxxxxxxxxxxxxxxx5d5807",
    "params": {
        "Orange": [
            {
                "phone_number": "22178xxxxxxx"
            }
        ],
        "amount": 100,
        "city": "Kenya",
        "client_callback_url": "https://webhook.site/",
        "country_id": 9,
        "currency": "XOF",
        "description": "Testing email",
        "email": "johnd@example.com",
        "first_name": "Test",
        "is_third_party_reference_1_unique": 1,
        "is_third_party_reference_2_unique": 1,
        "last_name": "Tester",
        "line1": "123",
        "mobile": "2217xxxxxxxx",
        "payment_method_type": "Orange",
        "payment_reference": "SENXOFORANGEPAYOUTTEST2",
        "postal_code": "000",
        "third_party_reference_1": "SENXOFORANGEPAYOUTTEST",
        "third_party_reference_2": "SENXOFORANGEPAYOUTTEST"
    }
}
Sample Response 
{
    "success": false,
    "message": "We apologize as we were not able to process your payment request. Please try again later.",
    "data": {
        "error": true,
        "message": "Duplicate third_party_reference_2 was found!"
    }
}
2. TZS Transaction Limit Update We have updated the transaction limits for TZS (Tanzanian Shilling) payouts. These new limits are now in effect and apply to all transactions made in TZS. Please review and adjust your integration accordingly to ensure compliance and avoid failed transactions. For full details on the updated limits, refer to the API documentation.