Get Order Information
Retrieve comprehensive information about card rail orders, including transaction status, amounts, fees, and blockchain transaction details. This endpoint is useful for order tracking, user-facing status displays, and reconciliation processes.
Quick Reference
URL
GET https://api.swipelux.com/api/public/orders/{orderId}
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
orderId | string | Yes | The ID of the order to get information about |
Authentication
This is a public endpoint - no API key required. The order ID serves as the authentication token.
Implementation Examples
Response Structure
Example Response
Order Status Values
Status | Description |
---|---|
PENDING | Order created but payment not yet initiated |
PROCESSING | Payment is being processed |
SUCCESS | Order completed successfully |
FAILED | Order failed during processing |
CANCELLED | Order was cancelled by user or system |
EXPIRED | Order expired before payment completion |
Transaction Types
Type | Description |
---|---|
card_payment | Credit/debit card payment processing |
crypto_transfer | Blockchain transfer to user wallet |
fee_collection | Fee collection transaction |
Common Use Cases
Order Status Display
Order Reconciliation
User Order History
Response Status Codes
Status Code | Description |
---|---|
200 | Order found and returned successfully |
404 | Order not found |
429 | Rate limit exceeded |
500 | Internal server error |
Rate Limits
The Get Order endpoint has generous rate limits:
- 100 requests per minute per IP address
- 1000 requests per minute per merchant account
For high-volume applications, consider caching order data and using webhooks for real-time updates instead of frequent polling.
Next Steps
- Real-time updates: Set up webhooks instead of polling for order status
- Error handling: Implement retry logic for temporary failures
- User experience: Display transaction URLs for blockchain verification