Orders
Order API & Status#
Creating an order is a foundational step in the payment process with our Payment Gateway. The Order API generates a unique order identifier (Order ID) that ensures secure and tamper-proof payment processing.Purpose#
Order Security: The Order ID safeguards payment requests, ensuring that the order amount and details cannot be tampered with.
Payment Binding: Each order is linked to a single successful payment, preventing duplicate transactions.
Integration Backbone: The Order ID is passed to the checkout process, enabling secure payment processing.
Workflow#
1.
Customer Action: When a customer clicks the "Pay" button on your website or app, an order is created with the Order API.
2.
Order ID Generation: The API generates a unique Order ID, along with associated transaction details like amount and currency.
3.
Secure Checkout: The Order ID is passed to our Checkout for secure payment handling.
Advantages#
Single Successful Payment per Order:
Guarantees that only one successful payment is associated with each order, preventing accidental multiple payments.
Efficient Database Queries:
Combines multiple payment attempts for a single order, streamlining database queries and reducing complexity.
Key Integration Steps#
1.
Create Order: Use the Order API to generate an Order ID with transaction details (amount, currency, and other metadata).
2.
Pass Order ID: Provide the Order ID to the EnKash Checkout during the payment process.
3.
Monitor Order Status: Use the status endpoints to track the order’s payment progress and completion.
OrderLifecycle#
Order Status#
| Status | Description |
|---|
CREATED | Order created successfully |
CHECKOUT_RENDERED | Customer was successfully redirected to the Enkash checkout page |
PAID | Payment is successful |
CANCELLED | Transaction was cancelled by the customer |
ATTEMPTED | Payment attempted by the customer |
EXPIRED | Order is expired |
Related Pages:#
Modified at 2025-01-09 20:47:40
