API Development And
Integration Guid
Place Order (pull‑codes)
Overview
Use this endpoint to purchase one or more digital gift cards by submitting SKUs and quantities. The API returns redeemable serial codes instantly—perfect for digital delivery, wallet credit, or automation workflows.
Endpoint & Environment
https
POST {baseUrl}/api/order/pull‑codes
- Sandbox URL: https://sandbox-service.wupex.com/api/order/pull-codes
- Production URL: https://service.wupex.com/api/order/pull-codes
Required Headers
https
x-api-key: YOUR_API_KEY Accept-Language: en-US Content-Type: application/json
- Ensure you use the correct sandbox or production key depending on your environment.
Request Body Structure
- Submit an array of order items, each containing:
|
Field
|
Type
|
Required
|
Description
|
|---|---|---|---|
|
merchant
|
string
|
Yes
|
Your merchant identifier
|
|
sku
|
string
|
Yes
|
Unique product code (productCode)
|
|
quantity
|
int
|
Yes
|
Number of units to order
|
Example Payload:
https
[
{
"merchant": "YourMerchantCode",
"sku": "GOOGLE-USA-10USD",
"quantity": 2
},
{
"merchant": "YourMerchantCode",
"sku": "APPLE-USA-15USD",
"quantity": 1
}
]
Sample Response
json
{
"data": {
"orderName": "A00000000000123",
"totalAmount": 35.00,
"serials": [
{ "sku": "GOOGLE-USA-10USD", "serialCode": "ABCD-EFGH-IJKL", "serialNumber": "1234-5678" },
{ "sku": "GOOGLE-USA-10USD", "serialCode": "MNOP-QRST-UVWX", "serialNumber": "9876-5432" },
{ "sku": "APPLE-USA-15USD", "serialCode": "YYYY-ZZZZ-AAAA", "serialNumber": "0000-1111" }
]
},
"status": true
}
Note: The “serials” array includes one entry per quantity ordered.
Response Field Breakdown
- data.orderName: Unique order ID (e.g., A00000000000123)
- data.totalAmount: Total cost of the order
- data.serials[]: Array of objects per item ordered:
- Default Reasonable Limits
- sku: Matches the productCode
- serialCode: Redeemable digital code
- serialNumber: Secondary code or serial (if applicable)
- status: true if successful, false otherwise
Best Practices
- Validate Stock: Use /api/product/merchant/invited/list first to verify product availability.
- Support Multiple Items: Send orders with different SKUs in a single call for efficiency.
- Capture Serial Data: Store all returned serial codes—these are your deliverables.
- Handle Errors and Retries: Log failures, inspect status, and retry failed items in small batches.
Error Handling
If the call fails, the API returns:
json
{
"status": false,
"error": {
"code": "INSUFFICIENT_STOCK",
"message": "Requested quantity not available."
}
}
Recommended flow:
- Retry a lesser quantity
- Notify end-users (e.g., “Only 2 units are in stock”)
- Avoid retrying on authentication failures (401, 403) without valid keys
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.