GET
/
payouts
/
{orderReference}
cURL
curl --request GET \
  --url https://api.clickpesa.com/third-parties/payouts/{orderReference} \
  --header 'Authorization: Bearer <token>'
[
  {
    "updatedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "id": "<string>",
    "orderReference": "<string>",
    "amount": "<string>",
    "currency": "<string>",
    "fee": "<string>",
    "status": "SUCCESS",
    "channel": "BANK TRANSFER",
    "channelProvider": "<string>",
    "transferType": "ACH",
    "notes": "<string>",
    "beneficiary": {
      "accountNumber": "<string>",
      "accountName": "<string>",
      "swiftNumber": "<string>",
      "routingNumber": "<string>",
      "beneficiaryMobileNumber": "<string>",
      "beneficiaryEmail": "jsmith@example.com"
    },
    "clientId": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Authorization header containing the JWT access token returned from the generate token endpoint. The token already includes the Bearer prefix. Example: Authorization: Bearer eyJhbGciOi...

Path Parameters

​
orderReference
string
required

Unique identifier for the payout order

Response

Query Payout Response

​
updatedAt
string<date-time>

Last updated timestamp

​
createdAt
string<date-time>

Creation timestamp

​
id
string

Payout ID

​
orderReference
string

Associated order reference

​
amount
string

Payout amount

​
currency
string

Currency code

​
fee
string

Transaction fee

​
status
enum<string>

Payout status

Available options:
SUCCESS,
PROCESSING,
PENDING,
FAILED,
REFUNDED,
REVERSED
​
channel
enum<string>

Payout channel

Available options:
BANK TRANSFER,
MOBILE MONEY
​
channelProvider
string

Name of the payout channel provider

​
transferType
enum<string>

Transfer type - when applicable

Available options:
ACH,
RTGS
​
notes
string

Additional notes if available

​
beneficiary
object
​
clientId
string

Application Client ID associated with the payout