Verifying your Payments

Before you give value or render a service for your customer's payment, It is very important to confirm the payment first.

📘

Verifying Orders (Payments) vs Confirming Order status

Verifying an order checks both the order status and the payment, while confirming an order's only checks it's status without providing the payment information.

To verify your order(payment), send your request containing the reference of the order to verify to the verify order endpoint.

Here are sample to guide your payment verification

Verify sample

// POST: https://checkout-api-service-dev.eks-alliancepay.com/checkout/order/verify
{
    "reference": "test_transaction_10"
}

200 response sample

{
  "data": {
    "order_reference": "test_transaction_12",
    "processor_reference": "PARORD-F55491CE-90EA-4597-9C1F-E19CFD884DA6",
    "product_name": "Collection",
    "total_amount_charged": 100,
    "payment_status": 1,
    "status": "Initiated",
    "payment_method": "Card Payment",
    "payment_response_code": "01",
    "payment_response_message": null,
    "narration": "Test Pay",
    "remarks": "Order initiated and created successfully",
    "currency_name": "NGN",
    "fee": 12,
    "fee_rate": 0.12,
    "subsidiary_fee": 0,
    "customer_fee": 0,
    "date_created": "2024-01-08T08:37:40.52",
    "date_updated": null,
    "date_payment_confirmed": null,
    "order_payments": [
      {
        "order_id": 460,
        "order_payment_reference": "PA-REF-F50EC949-3750-423D-AACD-6CB4D2C0070D",
        "payment_option": "Card Payment",
        "status_id": 1,
        "payment_status": "Initiated",
        "response_code": "01",
        "response_message": "pending-authenticaion",
        "order_payment_instrument": null,
        "remarks": "Order payment initiated",
        "date_created": "2024-01-08T09:58:43.32",
        "date_updated": null
      }
    ],
    "customer": {
      "customer_id": null,
      "first_name": "Test",
      "last_name": "User",
      "email_address": "[email protected]",
      "country_short_name": "NG",
      "customer_group": "Default",
      "country_id": 0,
      "global_status_id": 2,
      "global_status": "Active",
      "mobile_number": "[phone]",
      "is_blacklisted": false,
      "reason_blacklisted": null,
      "date_created": "2023-08-24T22:20:36.923",
      "date_updated": null
    },
    "card_details": []
  },
  "status": "success",
  "message": "Order details fetched successfully"
}

🚧

Authentication

Authorize your verify requests using your private-key NOT your public-key.