カスタムストアAPI / クーポン
クーポン（v1.1）
お客様が使えるクーポンを探し、担当者の承認後に会員へ発行します。照会はcoupons、発行はcoupon_issueで有効にします。
クーポン一覧
GET
/v1/couponslimitnumber任意
デフォルト20、最大50
発行できるクーポン（テンプレート）です。削除したクーポンは除外するか、deleted: "T"にしてください。
レスポンス — 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 }
}会員の保有クーポン
GET
/v1/customers/{member_id}/coupons会員がいなければ404、クーポンがなければ{ "data": [] }です。
レスポンス — 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"
}
]
}クーポン発行
POST
/v1/coupons/{coupon_no}/issues承認後にのみ呼び出します
クーポン発行はお金が関わる書き込みのため、担当者が承認した後にのみ呼び出します。
issued_member_scopestring必須
"M"（特定の会員）
member_idstring必須
受け取る会員のID
requested_bystring必須
"lillo"
send_sms_for_issuestring任意
"T"/"F"
リクエスト
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"
}
}'レスポンス — 201 Created
{
"data": {
"coupon_no": "6070000000000000012",
"member_id": "m_1001",
"issue_no": "9001",
"expiration_date": "2026-12-31T23:59:59+09:00"
}
}すでに同じクーポンを持っている、または発行上限に達した場合は409 coupon_unavailableです。非会員への発行はありません。