2
回答済み API

クーポンの利用を取り消せるのはいつまでですか?

グレープ · 2026/11/10 09:10

社内でユーザー向けアプリのクーポン画面を作っています。店頭で誤って「利用する」を押した場合、アプリから取り消すことはできますか?

また、利用や取り消しが断られたときに、理由を画面に出し分ける方法があれば教えてください。


回答 (1)

利用から10分以内であれば、POST /api/v1/user/coupons/{storeId}/{couponId}/use/undo で取り消せます。10分を過ぎた後は、店舗の側でしか変更できません。

  • 利用の応答に入る undoUntil が、取り消せる期限です。取り消しボタンの表示に使えます。
  • 取り消しても、利用して取り消したという記録は残ります。
  • 必要なスコープは user.coupons.write です。

断られたときは、本文の error に理由が入ります。

  • 利用(/use): 409 は already_used、reusable。404 は unavailable、expired、inactive。
  • 取り消し(/use/undo): 409 は not_used、window_passed。404 は not_issued。

reusable は何度でも使えるクーポンで、利用済みの状態を持ちません。クーポンを表示するだけで足ります。

下田 スタッフ · 2026/11/12 13:25

回答するにはログインが必要です。

ログイン