Custom store API / Coupons

Coupons (v1.1)

Find coupons a customer can use and, after a team member approves, issue them to the member. Turn on lookup with coupons and issuing with coupon_issue.

List coupons

GET/v1/coupons

limitnumberOptional

Default 20, max 50

ParameterTypeRequiredDescription

limitnumberOptionalDefault 20, max 50

Coupons (templates) that can be issued. Leave out deleted coupons or mark them deleted: "T".

Response — 200 OK

{
  "data": [
    {
      "coupon_no": "6070000000000000012",
      "coupon_name": "Come back 10% off",
      "benefit_type": "B",
      "benefit_text": "10% off (up to 5,000 KRW)",
      "available_begin_datetime": "2026-11-01T00:00:00+09:00",
      "available_end_datetime": "2026-12-31T23:59:59+09:00",
      "issue_type": "M",
      "deleted": "F"
    }
  ],
  "meta": { "next_cursor": null }
}

Member's coupons

GET/v1/customers/{member_id}/coupons

Return 404 if the member doesn't exist, and { "data": [] } if they have no coupons.

Response — 200 OK

{
  "data": [
    {
      "coupon_no": "6070000000000000012",
      "coupon_name": "Come back 10% off",
      "benefit_text": "10% off",
      "issued_date": "2026-11-02T10:00:00+09:00",
      "expiration_date": "2026-12-31T23:59:59+09:00",
      "used_coupon": "F"
    }
  ]
}

Issue a coupon

POST/v1/coupons/{coupon_no}/issues

Called only after approval

Issuing a coupon involves money, so it's called only after a team member approves it.

issued_member_scopestringRequired

"M" (a specific member)

member_idstringRequired

Member ID to receive the coupon

requested_bystringRequired

"lillo"

send_sms_for_issuestringOptional

"T"/"F"

ParameterTypeRequiredDescription

issued_member_scopestringRequired"M" (a specific member)

member_idstringRequiredMember ID to receive the coupon

requested_bystringRequired"lillo"

send_sms_for_issuestringOptional"T"/"F"

Request

curl -X POST "https://api.mall.example.com/v1/coupons/6070000000000000012/issues" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01" \
  -H "Idempotency-Key: 6f1c2a9e-4b7d-4f0e-9a51-3d2c8e7b1a04" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "issued_member_scope": "M",
      "member_id": "m_1001",
      "send_sms_for_issue": "F",
      "requested_by": "lillo"
    }
  }'

Response — 201 Created

{
  "data": {
    "coupon_no": "6070000000000000012",
    "member_id": "m_1001",
    "issue_no": "9001",
    "expiration_date": "2026-12-31T23:59:59+09:00"
  }
}

Return 409 coupon_unavailable if the member already has this coupon or the issue limit is reached. Coupons can't be issued to guests.

PreviousOrder writes NextErrors & idempotency