To send rewards through the API, you create an order. An order wraps the payment for a reward; the order item inside it is the gift being issued and delivered. The two have separate statuses — see the Order lifecycle guide.
Example order:
{
"id": 33729,
"status": "COMPLETED",
"order_item": {
"id": 33744,
"status": "PENDING",
"price": { "amount": 10000.0, "currency": "KRW" },
"transaction_fee_rate": 0
},
"total_price_charged": {
"amount": 7.34,
"currency": "USD",
"applied_exchange_rate": { "rate": 0.000734, "currency": { "from": "KRW", "to": "USD" } }
},
"external_reference_id": "myfirstorder001"
}total_price_charged is the amount debited from your account balance — converted to your account currency when the product is priced in a different currency.
