Verify Order
curl --request POST \
--url https://checkout-api-service.epayclub.com/checkout/order/verify \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '
{
"reference": "<string>"
}
'import requests
url = "https://checkout-api-service.epayclub.com/checkout/order/verify"
payload = { "reference": "<string>" }
headers = {
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({reference: '<string>'})
};
fetch('https://checkout-api-service.epayclub.com/checkout/order/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://checkout-api-service.epayclub.com/checkout/order/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://checkout-api-service.epayclub.com/checkout/order/verify"
payload := strings.NewReader("{\n \"reference\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://checkout-api-service.epayclub.com/checkout/order/verify")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://checkout-api-service.epayclub.com/checkout/order/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderReference": "805551685",
"paymentReference": "EPCLB-3134A6BDF47211EF93AB06BA2661E92B",
"productName": "Collection",
"totalAmountCharged": 106,
"statusId": 4,
"status": "Failed",
"paymentMethod": "Card Payment",
"paymentResponseCode": "12",
"paymentResponseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"narration": "Pay",
"remarks": "Order initiated and created successfully",
"currencyId": 6,
"paymentLinkId": null,
"paymentLinkReference": null,
"recurringPaymentId": null,
"recurringPaymentReference": null,
"currencyName": "USD",
"fee": 6,
"feeRate": 6,
"subsidiaryFee": 0,
"customerFee": 6,
"dateCreated": "2025-02-26T18:47:56",
"dateUpdated": "2025-02-26T19:05:35.717496",
"datePaymentConfirmed": null,
"orderPayments": [
{
"orderId": 29,
"orderPaymentReference": "PGW-PAYREF-3B315861F627474FA83852DBDD6CE71A",
"paymentOptionId": 2,
"paymentOption": "Card Payment",
"statusId": 4,
"status": "Failed",
"responseCode": "12",
"responseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"orderPaymentInstrument": null,
"remarks": "Order payment initiated",
"dateCreated": "2025-02-26T19:05:21.723112",
"dateUpdated": "2025-02-26T19:05:35.717595"
}
],
"customer": {
"customerId": null,
"firstName": null,
"lastName": null,
"emailAddress": null,
"countryShortName": null,
"customerGroup": null,
"countryId": 0,
"globalStatusId": 0,
"globalStatus": null,
"mobileNumber": null,
"isBlacklisted": false,
"reasonBlacklisted": null,
"dateCreated": "0001-01-01T00:00:00",
"dateUpdated": null
},
"cardDetails": [
{
"orderPaymentId": 19,
"status": true,
"country": null,
"cardToken": null,
"cardExpiryMonth": null,
"cardExpiryYear": null,
"cardType": null,
"cardIssuer": null,
"cardFirstSixDigits": null,
"cardLastFourDigits": null,
"dateCreated": "2025-02-26T19:05:35.729312",
"appEnvironmentId": 1
}
],
"paymentLink": null
},
"status": "success",
"statusCode": "00",
"message": "Order details fetched successfully"
}
{
"status": "failed",
"status_code": "13",
"message": "Order not found at the moment"
}
Orders
Verify Order
Retrieve the customer order details.
POST
/
checkout
/
order
/
verify
Verify Order
curl --request POST \
--url https://checkout-api-service.epayclub.com/checkout/order/verify \
--header 'Content-Type: application/json' \
--header 'api-key: <api-key>' \
--data '
{
"reference": "<string>"
}
'import requests
url = "https://checkout-api-service.epayclub.com/checkout/order/verify"
payload = { "reference": "<string>" }
headers = {
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({reference: '<string>'})
};
fetch('https://checkout-api-service.epayclub.com/checkout/order/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://checkout-api-service.epayclub.com/checkout/order/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://checkout-api-service.epayclub.com/checkout/order/verify"
payload := strings.NewReader("{\n \"reference\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://checkout-api-service.epayclub.com/checkout/order/verify")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://checkout-api-service.epayclub.com/checkout/order/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"orderReference": "805551685",
"paymentReference": "EPCLB-3134A6BDF47211EF93AB06BA2661E92B",
"productName": "Collection",
"totalAmountCharged": 106,
"statusId": 4,
"status": "Failed",
"paymentMethod": "Card Payment",
"paymentResponseCode": "12",
"paymentResponseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"narration": "Pay",
"remarks": "Order initiated and created successfully",
"currencyId": 6,
"paymentLinkId": null,
"paymentLinkReference": null,
"recurringPaymentId": null,
"recurringPaymentReference": null,
"currencyName": "USD",
"fee": 6,
"feeRate": 6,
"subsidiaryFee": 0,
"customerFee": 6,
"dateCreated": "2025-02-26T18:47:56",
"dateUpdated": "2025-02-26T19:05:35.717496",
"datePaymentConfirmed": null,
"orderPayments": [
{
"orderId": 29,
"orderPaymentReference": "PGW-PAYREF-3B315861F627474FA83852DBDD6CE71A",
"paymentOptionId": 2,
"paymentOption": "Card Payment",
"statusId": 4,
"status": "Failed",
"responseCode": "12",
"responseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"orderPaymentInstrument": null,
"remarks": "Order payment initiated",
"dateCreated": "2025-02-26T19:05:21.723112",
"dateUpdated": "2025-02-26T19:05:35.717595"
}
],
"customer": {
"customerId": null,
"firstName": null,
"lastName": null,
"emailAddress": null,
"countryShortName": null,
"customerGroup": null,
"countryId": 0,
"globalStatusId": 0,
"globalStatus": null,
"mobileNumber": null,
"isBlacklisted": false,
"reasonBlacklisted": null,
"dateCreated": "0001-01-01T00:00:00",
"dateUpdated": null
},
"cardDetails": [
{
"orderPaymentId": 19,
"status": true,
"country": null,
"cardToken": null,
"cardExpiryMonth": null,
"cardExpiryYear": null,
"cardType": null,
"cardIssuer": null,
"cardFirstSixDigits": null,
"cardLastFourDigits": null,
"dateCreated": "2025-02-26T19:05:35.729312",
"appEnvironmentId": 1
}
],
"paymentLink": null
},
"status": "success",
"statusCode": "00",
"message": "Order details fetched successfully"
}
{
"status": "failed",
"status_code": "13",
"message": "Order not found at the moment"
}
A unique identifier to track the payment.
{
"data": {
"orderReference": "805551685",
"paymentReference": "EPCLB-3134A6BDF47211EF93AB06BA2661E92B",
"productName": "Collection",
"totalAmountCharged": 106,
"statusId": 4,
"status": "Failed",
"paymentMethod": "Card Payment",
"paymentResponseCode": "12",
"paymentResponseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"narration": "Pay",
"remarks": "Order initiated and created successfully",
"currencyId": 6,
"paymentLinkId": null,
"paymentLinkReference": null,
"recurringPaymentId": null,
"recurringPaymentReference": null,
"currencyName": "USD",
"fee": 6,
"feeRate": 6,
"subsidiaryFee": 0,
"customerFee": 6,
"dateCreated": "2025-02-26T18:47:56",
"dateUpdated": "2025-02-26T19:05:35.717496",
"datePaymentConfirmed": null,
"orderPayments": [
{
"orderId": 29,
"orderPaymentReference": "PGW-PAYREF-3B315861F627474FA83852DBDD6CE71A",
"paymentOptionId": 2,
"paymentOption": "Card Payment",
"statusId": 4,
"status": "Failed",
"responseCode": "12",
"responseMessage": "Transaction failed: Card transaction blocked due to change in the credit card details from the registered one",
"orderPaymentInstrument": null,
"remarks": "Order payment initiated",
"dateCreated": "2025-02-26T19:05:21.723112",
"dateUpdated": "2025-02-26T19:05:35.717595"
}
],
"customer": {
"customerId": null,
"firstName": null,
"lastName": null,
"emailAddress": null,
"countryShortName": null,
"customerGroup": null,
"countryId": 0,
"globalStatusId": 0,
"globalStatus": null,
"mobileNumber": null,
"isBlacklisted": false,
"reasonBlacklisted": null,
"dateCreated": "0001-01-01T00:00:00",
"dateUpdated": null
},
"cardDetails": [
{
"orderPaymentId": 19,
"status": true,
"country": null,
"cardToken": null,
"cardExpiryMonth": null,
"cardExpiryYear": null,
"cardType": null,
"cardIssuer": null,
"cardFirstSixDigits": null,
"cardLastFourDigits": null,
"dateCreated": "2025-02-26T19:05:35.729312",
"appEnvironmentId": 1
}
],
"paymentLink": null
},
"status": "success",
"statusCode": "00",
"message": "Order details fetched successfully"
}
{
"status": "failed",
"status_code": "13",
"message": "Order not found at the moment"
}
⌘I