This API call searches and reconciles transactions that have been sent with an invalid or missing account and moves it to the specified account from the reconciliations queue. If successful, it triggers the Instant Payment Notification process sending relevant SMS, email and IPN URL notification.
The API service endpoint for making the Reconcile Transaction API call is:
https://developer.lipisha.com/index.php/v2/api/reconcile_transaction
The API request is made via HTTP POST and must be url encoded. Some of the parameters are required while others are optional. The parameters are:
Parameter | Description | Example |
---|---|---|
api_key | Unique string specifying merchant's Lipisha API key. This should match the api key that you have generated for your Lipisha account |
3aa67677e8bf1d4c8fe886a38c03a860 |
api_signature | Unique string specifying merchant's Lipisha API signature. This should match the api signature that you have generated for your Lipisha account |
SYetmwsNnb5bwaZRyeQ..........KhZNNkCoEx+5x= |
api_version | String specifying the version of the API in use | 1.3.0 |
api_type | String specifying the type of handshake or IPN call | Callback |
transaction | String specifying the unique code that identifies the transaction. E.g the M-Pesa confirmation code received after carrying out an M-Pesa payment | NMQR38SJDI |
transaction_mobile_number | Integers specifying mobile number of the person or entity that made the transaction. | 254722002222 |
transaction_account_number | Integers specifying the transaction account in which to move the transaction to if found. | 00155 |
transaction_reference | String specifying the reference to use as part of the transaction. E.g. invoice number or receipt number | LS0009 |
The API reponse will be returned as JSON. Each response will contain a status and content section. The parameters are:
Parameter | Description | Example |
---|---|---|
Status | ||
status | String specifying whether API Call executed successfully or failed | SUCCESS |
status_code | Integers specifying status code of the API Call result | 0000 |
status_description | String containing description of the status | Transactions found |
Content | ||
Array Of Transactions | ||
transaction | Unique code that identify transaction. E.g the M-Pesa confirmation code received after carrying out an M-Pesa payment | NMQR38SJDI |
transaction_type |
String specifying type of transaction.
Possible transaction types include:
|
Payment |
transaction_method |
String specifying the method used to carry out the transaction.
Possible transaction methods include:
|
Paybill (M-Pesa) |
transaction_date |
String specifying date and time when transaction was carried out.
In the format: YYYY-MM-DD HH:mm:ss |
2013-07-18 12:23:57 |
transaction_account_name | String specifying the name of the transaction account in which the transaction was moved to. | Test Account |
transaction_account_number | Integers specifying number of the transaction account in which the transaction was moved to. | 00155 |
transaction_reference | String specifying the reference the customer used when entering transactions. E.g. invoice number or receipt number | LS0009 |
transaction_amount | Number specifying the value of the transactions. Note that withdrawals and other charges e.g. fees are indicated as a negative amount | 350.0000 |
transaction_status |
Strings specifying the status of a transaction.
Possible transaction status include:
|
Completed |
transaction_name | String specifying name of the person or entity that made a transaction. | JOHN JANE DOE |
transaction_mobile_number | Integers specifying mobile number of the person or entity that made a transaction. | 254722002222 |
transaction_email | String specifying email address of the person or entity that made a transaction. | test@test.com |
{
"status": {
"status_code": 0,
"status_description": "Transactions Reconciled",
"status": "SUCCESS"
},
"content": [
{
"transaction": "NMQR38SJDI",
"transaction_type": "Payment",
"transaction_method": "Paybill (M-Pesa)",
"transaction_date": "2013-07-18 12:23:57",
"transaction_account_name": "Test Account",
"transaction_account_number": "00155",
"transaction_reference": "LS0009",
"transaction_amount": "350.0000",
"transaction_status": "Completed",
"transaction_name": "JOHN JANE DOE",
"transaction_mobile_number": "254722002222",
"transaction_email": ""
},
{
"transaction": "DS54EX316",
"transaction_type": "Fees",
"transaction_method": "Paybill (M-Pesa)",
"transaction_date": "2013-07-18 15:13:21",
"transaction_account_name": "Test Account",
"transaction_account_number": "00155",
"transaction_reference": "LS0009",
"transaction_amount": "1.5000",
"transaction_status": "Completed",
"transaction_name": "JOHN JANE DOE",
"transaction_mobile_number": "254722002222",
"transaction_email": ""
}
]
}