About Order
OrderID, which acts as the core reference throughout the transaction lifecycle.Purpose
Order Security: Ensures transaction integrity by preventing tampering with amount or details.
Payment Binding: Ties a single successful payment to each order to avoid duplicates.
Integration Backbone: Links the order to Checkout, enabling a secure and traceable flow.
Payment Binding: Ties a single successful payment to each order to avoid duplicates.
Integration Backbone: Links the order to Checkout, enabling a secure and traceable flow.
Workflow
Customer Action
The customer clicks the "Pay" button on your platform.
Order Creation
Your backend calls the Order API, which returns a unique Order ID along with transaction details (amount, currency, etc.).
Checkout Integration
The Order ID is passed to the EnKash Checkout for secure and streamlined payment handling.
Advantages
Prevents multiple payments from being accepted against the same order.
Simplifies reconciliation by associating multiple payment attempts to a single order.
Key Integration Steps
Create Order
Use the Create Order API with transaction metadata such as
amount, currency, and optional custom fields.Initiate Checkout
Pass the generated
OrderID to EnKash Checkout for rendering the payment UI.Track Order
Use Get Order Status or related APIs to monitor order status through the payment lifecycle.
Order Lifecycle Statuses
| Status | Description |
|---|---|
CREATED | Order successfully created and ready for Checkout |
CHECKOUT_RENDERED | Customer redirected to EnKash Checkout |
ATTEMPTED | Customer attempted payment |
PAID | Payment completed successfully |
CANCELLED | Customer canceled the transaction |
EXPIRED | Order expired due to timeout or inactivity |