クーポン作成

このAPIは割引クーポンを作成する機能を提供します。

複数のクーポンを同時に作成する場合は、ダッシュボードをご利用ください。

APIからクーポン画像をアップロードすることはできません。
画像が必要な場合は、まずダッシュボードでクーポングループを作成し、画像を登録した上でクーポン作成時にそのグループを指定してください。

このAPIはパーソナルプラン以上で利用可能です。

POST

/api/coupon/v1/create 

{
    "cpnNo": "",  // If left empty, a 16-character code will be generated automatically by the system.
    "nm": "$5 discount coupon",
    "discTypeIdx": 458,
    "disc": 5,
    "discCurrency": "USD",
    "strtYmd": "2025-01-01",
    "endYmd": "2025-12-31",
    "useLimit": 1,
    "grpIdx": 271,
    "tmplIdx": 0,
    "onsiteYn": "Y",
    "onsitePwd": "123456",
    "memo": "New Member Registration, IP: 211.111.222.33",
    "url": "https://bestshop.com",
    "userId": "att78z",
    "userNm": "Brown Smith",
    "userPhnno": "+1 123-4567-8900",
    "userEml": "test@gmail.com",
    "userEtc1": "Gold rating",
    "userEtc2": ""
}

Request Parameters

cpnNostring
クーポン番号。 英数字8～16桁。値がない場合はシステムで自動生成されます。特殊文字は使用不可。
例: V5H8GR5T
nmstringrequired
クーポン名。
discTypeIdxintegerrequired
割引タイプ。（457: 割引率 %, 458: 金額割引）
discdoublerequired
割引率（457）の場合: 1～100% の範囲。 金額割引（458）の場合: 金額を入力。
discCurrencystring
通貨単位。金額割引（discTypeIdx:458）を使用する場合は必須。
strtYmddaterequired
クーポン有効開始日。例: 2024-10-01
endYmddaterequired
クーポン有効期限日。例: 2024-12-31
有効期限は翌年の12月31日までしか設定できません。
useLimitintegerrequired
クーポン使用可能回数。（0: 無制限、1～5: 回数制限）
2回以上に設定する場合は userId を必ず指定する必要があります。
grpIdxinteger
クーポングループ。 グループで管理する場合に使用します。グループIDXはダッシュボードで確認可能。
グループ設定とクーポン設定が重複する場合は、グループ設定が優先されます。
tmplIdxinteger
クーポンテンプレート。 クーポン作成時に参照するテンプレート。テンプレートIDXはダッシュボードで確認可能。
onsiteYnstring
店舗用クーポンの有無。クーポンページに 「クーポンを使用」 ボタンを表示。
オフライン店舗でスタッフが利用処理を行う際に必要。
onsitePwdstring
店舗用クーポンのパスワード。クーポン利用時に必要。
memostring
内部参照用メモ。
urlstring
URLを入力すると、クーポンページに 「クーポンを使う」 ボタンが表示されます。
ボタンまたはクーポン画像をクリックすると、そのURLにリダイレクトされます。
colorstring
クーポン文字色。HEX値で指定。例: #4F4F4F
backgroundstring
クーポン背景色。HEX値で指定。例: #FFFFFF
userIdstring
クーポン発行対象者を管理するために使用。
使用回数が2～5に設定されている場合は必須入力。通常は会員のログインIDまたは英字氏名を指定。
userNmstring
クーポン利用者名。内部管理用。
userPhnnostring
クーポン利用者の連絡先。内部管理用。
userEmlstring
クーポン利用者のメールアドレス。内部管理用。
userEtc1string
追加の内部管理用フィールド。
userEtc2string
追加の内部管理用フィールド。 
{
    "code": 0,
    "message": "",
    "result": "ZJLF0399WQBEQZJM"
}

Response Parameters

codeinteger
応答コード: 0 = 成功、それ以外の値 = エラー
messagestring
応答メッセージです。応答コードが0でない場合、エラーメッセージが返されます。
resultstring
応答値。生成されたクーポン番号が返されます。
例: ZJLF0399WQBEQZJM