Orders

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.