3. Sending your first reward

Step 1 — Pick a product

Browse the catalog and pick something orderable. For example, Korean gift cards:

curl --request GET \
     --url 'https://biz-sandbox-api.sodagift.com/v1/products?country_code=KR&page=0&size=20' \
     --header 'SODA-API-KEY: YOUR-API-KEY' \
     --header 'accept: application/json'

From the response, note a product where:

• availability is ON_SALE — only these can be ordered
• available_delivery_method includes EMAIL
• amount is the fixed price you'll pay. (Some products instead return min_amount/max_amount — those accept a custom_amount of your choosing in the order request.)

We'll use the 7-Eleven ₩10,000 gift card (id: 10432) from the Sandbox catalog below.

⚠️

Product IDs differ between accounts and environments — always use an id from your own catalog response, not the one in this example.

Step 2 — Create the order

Send the gift to your own email address. Replace your key and your email:

curl --request POST \
     --url 'https://biz-sandbox-api.sodagift.com/v1/orders' \
     --header 'SODA-API-KEY: YOUR-API-KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "item": {
    "id": 10432
  },
  "delivery": {
    "method": "EMAIL",
    "recipient": {
      "name": "John Smith",
      "email": "[email protected]"
    },
    "sender": {
      "name": "John Smith"
    }
  },
  "message": "Congratulations!",
  "external_reference_id": "myfirstorder001"
}
'

A successful response looks like this:

{
  "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"
}

Two things worth noticing:

• The order is COMPLETED (payment settled from your balance), and the order item starts as PENDING — it flips to COMPLETED once the gift is issued and delivered, usually within seconds to a few minutes. See Order lifecycle.
• The product is priced in KRW, but your balance is charged in your account currency — total_price_charged shows the converted amount and the exchange rate applied.

📘

external_reference_id is your own idempotency key: if you retry the same request, you get the same order back instead of a duplicate. See Idempotency & retries.

Step 3 — Check your inbox and track the order

The reward arrives in your inbox shortly. You can also track it via the API (use the id from the response above):

curl --request GET \
     --url 'https://biz-sandbox-api.sodagift.com/v1/orders/33729' \
     --header 'SODA-API-KEY: YOUR-API-KEY' \
     --header 'accept: application/json'

Congrats — you're up and running! 🎉

Where to go next: Delivery methods to choose how gifts reach your recipients, and Order lifecycle to build reliable tracking.