API Development And
Integration Guide
Common Errors
When integrating with WUPEX, it’s crucial to handle common error scenarios correctly. A well-structured approach ensures a reliable user experience and simplifies troubleshooting.
Error Response Structure
All error responses follow this JSON pattern:
json
{
"status": false,
"error": {
"code": "ERROR_CODE",
"message": "Descriptive message to help fix the issue"
}
}
- status: Always false on failure
- error.code: A concise machine-readable identifier
- error.message: A clear, actionable explanation (no sensitive data)
Most Common Error Types
4xx Client Errors
- 400 Bad Request – Malformed request (e.g., missing required fields)
- 401 Unauthorized – Missing or invalid API key
- 403 Forbidden – No permission to access endpoint
- 404 Not Found – Requested resource (e.g., SKU, order) doesn’t exist
- 408 Request Timeout – No response received in time
- 409 Conflict – Conflicting request state or duplicate resource
- 413 Payload Too Large – Request body exceeds allowed size
- 422 Unprocessable Entity – Request is syntactically correct, but semantically invalid (e.g., quantity = 0)
5xx Server Errors
- 500 Internal Server Error – Unexpected server-side failure
- 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout – API backend issues or maintenance
Handling & Best Practices
- Step 1: Authentication
- Use your x-api-key in every request header:
make file
x-api-key: YOUR_API_KEY Accept-Language: en-US
Step 2: Fetch Available Gift Cards
json
[
{
"merchant": "YourMerchantCode",
"sku": "APPLE-USA-2USD",
"quantity": 1
}
]
Get product names, codes, pricing, and availability in real time.
Step 3: Place an Order
https
POST /api/order/pull-codes
https
POST /api/product/merchant/invited/list Content-Type: application/json
json
[
{
"merchant": "YourMerchantCode",
"sku": "APPLE-USA-2USD",
"quantity": 1
}
]
Step 4: Check Order Statust
https
GET /api/order/detail?orderName=A00000000000001
Returns product serial codes, value, and fulfillment details.
Balance & Credit
https
GET /api/customer/balance
json
{
"balance": 5000.00,
"credit": 0.00,
"creditBalance": 5000.00
}
Get Started
Product API
Order API
Customer API
Common Parameters & Headers
Error Handling & Status Codes (Optional)
Postman Collection & Tools (Optional)
Let’s Boost Your
Business Efficiency
Say goodbye to delays, fraud, and complex setups—our solution is built for speed and trust.
Get Latest News for Free!
Sign up to get product updates, new partner alerts, and
exclusive API insights
exclusive API insights
No spam. Unsubscribe anytime
Why WUPEX?
Partners
- Apple
- PSN
- Razer Gold
- Xbox
- PUBG
- Steam
- Jawaker
- Roblox
- Fornite
- Minecraft
- Yalla Ludo
- FC Mobile
- Freefire
Industries
- Banks & Fintech
- Retail & eCommerce
- Payment Gateways
- Telecom & Wallets
- Gaming & Esports
- Corporate Gifting
Resources
- Blog
- FAQ
Company
- About Us
- Meet Our Team
- Contact Us
- Partnership
- Terms & Conditions
Downloads
- Catalogue
- Company Profile
- API Documentation
Features
- Seamless Integration
- Secured API
- Real-Time Delivery
- Bulk Digital Gift Cards
- Fraud Prevention
- Global Brand Access
Support
- Get Started
- Customer Support
- Portal Guide
- API Integration Guide
- Help Center
Copyright © 2024 WUPEX | All Rights Reserved.
Why WUPEX?
Partners
- Apple
- PSN
- Razer Gold
- Xbox
- PUBG
- Steam
- Jawaker
- Roblox
- Fornite
- Minecraft
- Yalla Ludo
- FC Mobile
- Freefire
Industries
- Banks & Fintech
- Retail & eCommerce
- Payment Gateways
- Telecom & Wallets
- Gaming & Esports
- Corporate Gifting
Features
- Seamless Integration
- Secured API
- Real-Time Delivery
- Bulk Digital Gift Cards
- Fraud Prevention
- Global Brand Access
Support
- Get Started
- Customer Support
- Portal Guide
- API Integration Guide
- Help Center
Company
- About Us
- Meet Our Team
- Contact Us
- Partnership
- Terms & Conditions
Resources
- Blog
- FAQ
Downloads
- Catalogue
- Company Profile
- API Documentation
Copyright © 2024 WUPEX | All Rights Reserved.