Transaction Status

Lipila supports the following transaction statuses:

Status	Description
Pending	The transaction is pending.
Successful	The transaction was successful.
Failed	The transaction failed.
Cancelled	The transaction was cancelled.

Transaction Types

Lipila supports the following transaction types:

Type	Description
Payment	A payment is a transaction where a customer pays you for a product or service.
Disbursement	A disbursement is a transaction where you pay a customer.

Transaction Currencies

Lipila supports the following transaction currencies:

Currency	Description
ZMW	Zambian Kwacha

Transaction Payment Types

Lipila supports the following transaction payment types:

Payment Type	Description
AirtelMoney	Airtel Money
MTNMoney	MTN Mobile Money
ZamtelKwacha	Zamtel Kwacha
Card	Card Payment
Cash	Cash Payment

Transaction Enquiry By Lipila ID

Here’s how to use the Lipila API to check the status of a transaction:

1. Make a GET request to the Lipila API with the transaction ID as the path parameter.

curl --location --request GET 'https://lipila-uat.hobbiton.app/transactions/status?transactionId=LPLTXN2403191437038442' \
--header 'Authorization: Bearer YOUR_SECRET_KEY'
--header 'Content-Type: application/json' \

Transaction Enquiry By Request ID

In a situation where the client has not received the transaction message from Lipila, Here’s how to use the Lipila API to check the status of a transaction using the Request ID:

1. Make a GET request to the Lipila API with the Request ID as the path parameter.

curl --location --request GET 'https://lipila-uat.hobbiton.app/transactions/request/status?requestId=00008-017-0128944227' \
--header 'Authorization: Bearer YOUR_SECRET_KEY'
--header 'Content-Type: application/json' \

Transaction Status Response

Below is a snpshot of the sameple response for the transaction status response

{
  "status": "Pending",
  "paymentType": "AirtelMoney",
  "currency": "string",
  "amount": 0,
  "accountNumber": "string",
  "cardDetails": {
    "cardNumber": "string",
    "expiryMonth": 0,
    "expiryYear": 0
  },
  "customer": {
    "fullName": "string",
    "phoneNumber": "string",
    "email": "string"
  },
  "ipAddress": "string",
  "message": "string",
  "transactionId": "string",
  "externalId": "string"
}