커스텀몰 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이에요. 비회원 발급은 없어요.