Updating Payout Requests

You can update payout requests by changing their status. The response will provide detailed information about the update status and other relevant details.

Headers

• Authorization: Bearer YOUR_SECRET_KEY - Your API secret key prefixed with "Bearer".
• Content-Type: application/json - Specifies the format of the request body.

Query Parameters

• payout_request_id: string (required) - The unique identifier for the payout request you want to update.

Body Parameters

• status: string (required) - New status of the payout request. Allowed values: "cancelled", "pending", "approved", "rejected", "completed".

Sample Request to Update a Payout Request

1. Update Payout Request Status

curl -X PUT "https://api.motapa.africa/v1/payout/request/update?payout_request_id=mp_payout_1234567890" \
-H "Authorization: Bearer mp_test_26PHem9AhJZvU623DfE1x4sd" \
-H "Content-Type: application/json" \
-d '{
  "status": "approved"
}'

Sample Responses

{
    "result": "success",
    "payout_request_id": "mp_payout_1234567890",
    "status": "approved",
    "message": "Payout request updated successfully."
}