This enables your application to send money to business wallet to wallet in lemonade.

BODY PARAMS

Parameter	Data Type	Description	Required
wallet_no	string	Business wallet account number assigned by Lemonade Payment	Y
reference	alphanumeric	Unique reference number. unique minimum:6 digit string for each transaction	Y
acc_name	string	recipient's Business name.	Y
acc_no	string	the recipient's wallet account	Y
currency	string	Transaction currency By Default KES for Mpesa	Y
amount	string	the amount. Max per transaction is KES 150,000	Y
description	string	any additional payment details the sender may have.	Y
channel	numeric	channel unique code. use 111111 for wallet to wallet	Y
result_url	string	this parameter holds the URL to your server to which callback response will be sent.	Y

HEADER PARAMS

Parameter	Data Type	Description	Required
Authorization	string	bearer token used to access the API	Y

200 Success Response Schema

Parameter	Data Type	Description
success	bool	Response code
message	string	Response message.

Example Request

                                    
curl --location 'https://here-prod-api-url.com/api/v2/payment' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer XXXXXXXXXXX' \
--data '{
"wallet_no": "XXXXXXXXX",
"reference": "xxxxx",
"acc_name": "John Doe",
"acc_no": "xxxxx",
"currency": "KES",
"amount": 50,
"channel": 111111,
"description": "Settlement 012",
"result_url":"https://webhook.site/1712d2f0-c63b-45fb-80c3-6389ad374b0b"
}
'
                                    
                                

Example Response

                                    
{
    "success": true,
    "message": "Successfully initiated",
    "data": {
        "transaction_id": "909830648685",
        "status": "PENDING",
        "status_description": "Transaction Initiated successfully"
    }
}           
                                

Example Success Transaction on the Return Url Response

                                    
{
  "channel": "100011",
  "reference": "12232",
  "transaction_id": "909830648685",
  "third_party_id": "SDLD82T35",
  "currency": "KES",
  "amount": "100",
  "fees": "2",
  "result_code": 0,
  "result_description": "The service request is processed successfully.",
  "hash": "d6e15ccdf590e58ac5ad4f52943fe16c4db8a605034a4565d21a86a886a7c1c4"
}