Skip to main content
POST
Place Order

Overview

Create orders for gift cards and digital products. Cards are delivered digitally via the /checkOrder endpoint.
Before ordering: Verify stock via /checkProduct and check account balance.

Request Body

string
required
Product ID from /catalog
string
required
Type ID from /checkProduct
integer
required
Number of cards to order (minimum: 1)

Examples

Success Response

Pre-Order Checklist

1

Verify Stock

2

Check Balance

3

Place Order

4

Poll for Cards

Error Responses

Invalid request parameters
Product out of stock
Not enough balance

Processing

Orders are final once placed. Save orderId immediately.
Most orders process within seconds. Poll /checkOrder/:orderId every 5-10 seconds until status is FULFILLED or REFUNDED.

Check Order

Get cards when fulfilled

Check Product

Verify stock first