Check the status of a payout transaction

PATH PARAMS

Parameter	Data Type	Description	Required
customer_code	alphanumeric	Business code assigned by Lemonade Payment	Y
account_no	alphanumeric	Business code assigned by Lemonade Payment	Y
reference	string	reference	Y

HEADER PARAMS

Parameter	Data Type	Description	Required
Authorization	alphanumeric	bearer token used to access the API	Y
signature	alphanumeric	A SHA-256 signature to proof that this request is coming from the merchant. Build a String of concatenated values of the request fields with the following order: reference,customer_code,account. The resulting text is then signed with Private Key and Base64 encoded.	Y

200 Success Response Schema

Parameter	Data Type	Description
code	numeric	Response code
message	string	Response message.
payout	object	Contains payout info. See below success and failed transaction response

Example Request

                                    
curl --location --request GET 'https://here-prod-api-url.com/payout/status/{customer_code}/{account_no}/order_reference' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'signature: mW6WDUM8cJA0hXvAWa3AmWOFruosfvNY\
--header 'Authorization: Bearer aJehRkDcOlFLMQaBRfboBMT_gpvcLxHVz_8zEg6N76U' \
--data-raw ''
                                    
                                

Example Successful Payout Transaction Response

                                    
{
    "code": 0,
    "success": true,
    "message": "SUCCESS",
    "payment": {
        "channel": "124491",
        "reference": "40513984",
        "transaction_id": "W9MDA15L96",
        "currency": "KES",
        "amount": "12722",
        "fees": "572.49",
        "result_code": 0,
        "result_description": "The service request is processed successfully.",
    }
}
                                    
                                

Example Failed Payout Transaction Response

                                    
{
    "code": 0,
    "success": true,
    "message": "SUCCESS",
    "payment": {
        "channel": "124491",
        "reference": "40513862",
        "result_code": 1032,
        "result_description": "Invalid Account Number"
    }
}