Verify Transaction

The Verify Transaction endpoint allows you to verify the status and details of a data purchase transaction made through the DiscountData API. By utilizing this endpoint, you can ensure the integrity of the transaction and retrieve the relevant information to update your systems or provide accurate notifications to your users.

Verify A Transaction Details

GET https://app.discountdata.ng/public/api/transaction/{reference_id}

Replace {reference_id} with an actual transaction reference.

Headers

Name	Type	Description
Authorization*	Bearer	Your API Bearer Token

200: OK

{
    "status": true,
    "data": {
        "transaction": {
            "service_plan_id": 45,
            "service": "Airtel",
            "phone_number": "0708xxxxxxx",
            "service_type": "Data Topup",
            "description": "Airtel CORPORATE GIFTING 500MB to 0708xxxxxxx",
            "amount": "0.5",
            "initial_balance": "4",
            "final_balance": "3.5",
            "reference": "K6H2SERHF98DN9",
            "status": "success",
            "created_at": "2023-07-12T20:00:44.000000Z",
            "true_response": "You have successfully gifted 234708xxxxxxx with 500MB of Data. valid till 8\/10\/2023 12:00:00 PM. 0708xxxxxxx",
            "webhook_response": {
                "success": true,
                "code": 200,
                "status": "successful",
                "message": "Transaction successful",
                "data": {
                    "service": "Data Topup",
                    "amount": "0.5",
                    "plan": "500MB",
                    "phone_number": "0708xxxxxxx",
                    "date": "2023-07-12T21:00:44.306168Z",
                    "message": "Airtel CORPORATE GIFTING 500MB to 0708xxxxxxx Reference ID Is : #K6H2SERHF98DN9",
                    "reference": "K6H2SERHF98DN9",
                    "network": "Airtel",
                    "wallet_balance": 3.5,
                    "true_response": "You have successfully gifted 234708xxxxxxxwith 500MB of Data. valid till 8\/10\/2023 12:00:00 PM. 0708xxxxxxx"
                }
            }
        }
    }
}

In the example above, a successful verification request for the transaction with reference ID "ABCD1234" returns the details of the verified transaction. The response includes the transaction ID, status ("completed" in this case), mobile number, data plan, purchase date, and expiry date.

Please note that the actual response may contain additional fields or information depending on the specific transaction and its associated details.

Handling Verify Transaction Responses

When you receive a response from the Verify Transaction endpoint, you can utilize the provided transaction details to update your systems, perform necessary validations, or trigger appropriate actions based on the transaction status.

For example, you can:

• Update user profiles or data usage statistics based on the verified transaction.

• Provide accurate notifications to users regarding the status or expiry date of their purchased data plan.

• Synchronize the verified transaction details with external systems or databases.

Make sure to handle the responses securely and perform any necessary validations to ensure the integrity and authenticity of the received data.

Error Handling

In case of an invalid or non-existent reference ID, the Verify Transaction endpoint will return an appropriate error response. It is essential to handle such error responses and provide meaningful feedback to users or log the error for further investigation and troubleshooting.

Now that you understand the purpose and usage of the Verify Transaction endpoint, you can leverage this functionality to verify and process data purchase transactions effectively.

If you have any further questions or require assistance regarding the Verify Transaction endpoint or any other aspect of the DiscountData API, please don't hesitate to contact our support team.

Let's continue exploring the other endpoints and functionalities provided by the DiscountData API!