LivePay API Documentation

Overview

The Transaction Status API allows you to check the current status of a specific transaction using its transaction ID.

What You Get

Detailed transaction information including status, amount, network, and timestamps.

Quick Start

Request Example

Terminal

curl -X POST "https://livepay.me/api/v1/transaction-status.php" \
  -H "Authorization: Bearer <--your-secret-key-->" \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "<--your-public-key-->",
    "transaction_id": "MP3f123d49c70ab593"
  }'

Response Example

JSON Response

{
  "status": "success",
  "transaction": {
    "transaction_id": "MP3f123d49c70ab593",
    "reference_id": "6d40a8ec-c75e-43c5-b3ac-17356c34be3e",
    "amount": "500",
    "phone": "256751936911",
    "network": "AIRTEL",
    "method": "DEPOSIT",
    "status": "Failed",
    "created_at": "",
    "completed_at": "2025-11-04 05:46:06",
    "description": "Payment Request."
  }
}

Authentication

This endpoint requires Bearer token authentication using your Secret Key in the Authorization header, and your Public Key in the request body.

Headers

Authorization

Bearer <--your-secret-key-->

Content-Type

application/json

Body Parameters

apikey

<--your-public-key-->

Request Parameters

Parameter	Type	Required	Description
`apikey`	String	Yes	Your public API key
`transaction_id`	String	Yes	LivePay transaction ID to check

Response Fields

Field	Type	Description
`status`	String	Request status (success/error)
`transaction`	Object	Transaction details object
`transaction.transaction_id`	String	LivePay transaction ID
`transaction.reference_id`	String	Your reference ID for the transaction
`transaction.amount`	String	Transaction amount
`transaction.phone`	String	Phone number used for transaction
`transaction.network`	String	Mobile network (AIRTEL/MTN)
`transaction.method`	String	Transaction type (DEPOSIT/WITHDRAW)
`transaction.status`	String	Transaction status (Success/Failed/Pending)
`transaction.created_at`	String	Transaction creation timestamp
`transaction.completed_at`	String	Transaction completion timestamp
`transaction.description`	String	Transaction description

Transaction Statuses

Status Types

Success Completed

Failed Error

Pending Processing

Important Notes

Transaction ID Required

You must provide a valid LivePay transaction ID to check the status. This is different from your reference you provided when sending transaction request.

Secure Access

Always use your Secret Key in secure environments. Never expose it in client-side code or public repositories.