Add Coupon API Support to Messaging API (#832)

line/line-openapi#111

# Add Coupon API Support to Messaging API
We've supported a set of new APIs that make it possible to create,
manage, and deliver coupons via the Messaging API. These features
provide functionality similar to what's available through the LINE
Official Account Manager interface ([see
here](https://www.lycbiz.com/jp/manual/OfficialAccountManager/coupons-create/)),
allowing developers to integrate coupon-related workflows into their
bots more flexibly.

For more details, see the official announcement:
[LINE Developers News — Coupon API Released
(2025/08/06)](https://developers.line.biz/en/news/2025/08/06/coupon-api/)

## New API Endpoints
- `POST /v2/bot/coupon`
Create a new coupon.
The request includes metadata such as the coupon title, description,
image URLs, validity period, reward details(e.g. 1000yen discount),
acquisition requirements, time zone, etc.

- `GET /v2/bot/coupon`
Retrieve a list of coupons associated with the bot.

- `GET /v2/bot/coupon/{couponId}`
Fetch detailed information about a specific coupon.

- `PUT /v2/bot/coupon/{couponId}`
Mark a coupon as expired.

## Messaging API Update
Message Object now supports a new type: `type=coupon`
This allows developers to send coupons directly to users via the
Messaging API, similar to sending text, image, or template messages.

## Example Requests
### Create a Coupon
```
POST /v2/bot/coupon
Content-Type: application/json
```
#### Request body
```json
{
  "title": "1000 yen off coupon",
  "acquisitionCondition": {
    "type": "normal"
  },
  "visibility": "PUBLIC",
  "startTimestamp": 1672537600,
  "endTimestamp": 1672624000,
  "maxUseCountPerTicket": 1,
  "reward": {
    "type": "discount",
    "priceInfo": {
      "priceInfoType": "fixed",
      "fixedAmount": 1000
    }
  },
  "imageUrl": "https://example.com/coupon_image.png",
  "barcodeImageUrl": "https://example.com/coupon_barcode.png",
  "timezone": "ASIA_TOKYO"
}
```
#### Response
```json
{
  "couponId": "abc1234"
}
```


### Send a Coupon Message

```json
{
  "to": "<userId>",
  "messages": [
    {
      "type": "coupon",
      "couponId": "abc1234"
    }
  ]
}
```

---------

Co-authored-by: github-actions <[email protected]>
Co-authored-by: habara keigo <[email protected]>

Author: 3 people

line-openapi

@@ -35,6 +35,8 @@
 from linebot.v3.messaging.exceptions import ApiException
 
 # import models into sdk package
+from linebot.v3.messaging.models.acquisition_condition_request import AcquisitionConditionRequest
+from linebot.v3.messaging.models.acquisition_condition_response import AcquisitionConditionResponse
 from linebot.v3.messaging.models.action import Action
 from linebot.v3.messaging.models.age_demographic import AgeDemographic
 from linebot.v3.messaging.models.age_demographic_filter import AgeDemographicFilter
@@ -53,13 +55,44 @@
 from linebot.v3.messaging.models.camera_roll_action import CameraRollAction
 from linebot.v3.messaging.models.carousel_column import CarouselColumn
 from linebot.v3.messaging.models.carousel_template import CarouselTemplate
+from linebot.v3.messaging.models.cash_back_fixed_price_info_request import CashBackFixedPriceInfoRequest
+from linebot.v3.messaging.models.cash_back_fixed_price_info_response import CashBackFixedPriceInfoResponse
+from linebot.v3.messaging.models.cash_back_percentage_price_info_request import CashBackPercentagePriceInfoRequest
+from linebot.v3.messaging.models.cash_back_percentage_price_info_response import CashBackPercentagePriceInfoResponse
+from linebot.v3.messaging.models.cash_back_price_info_request import CashBackPriceInfoRequest
+from linebot.v3.messaging.models.cash_back_price_info_response import CashBackPriceInfoResponse
 from linebot.v3.messaging.models.chat_reference import ChatReference
 from linebot.v3.messaging.models.clipboard_action import ClipboardAction
 from linebot.v3.messaging.models.clipboard_imagemap_action import ClipboardImagemapAction
 from linebot.v3.messaging.models.confirm_template import ConfirmTemplate
+from linebot.v3.messaging.models.coupon_cash_back_reward_request import CouponCashBackRewardRequest
+from linebot.v3.messaging.models.coupon_cash_back_reward_response import CouponCashBackRewardResponse
+from linebot.v3.messaging.models.coupon_create_request import CouponCreateRequest
+from linebot.v3.messaging.models.coupon_create_response import CouponCreateResponse
+from linebot.v3.messaging.models.coupon_discount_reward_request import CouponDiscountRewardRequest
+from linebot.v3.messaging.models.coupon_discount_reward_response import CouponDiscountRewardResponse
+from linebot.v3.messaging.models.coupon_free_reward_request import CouponFreeRewardRequest
+from linebot.v3.messaging.models.coupon_free_reward_response import CouponFreeRewardResponse
+from linebot.v3.messaging.models.coupon_gift_reward_request import CouponGiftRewardRequest
+from linebot.v3.messaging.models.coupon_gift_reward_response import CouponGiftRewardResponse
+from linebot.v3.messaging.models.coupon_list_response import CouponListResponse
+from linebot.v3.messaging.models.coupon_message import CouponMessage
+from linebot.v3.messaging.models.coupon_others_reward_request import CouponOthersRewardRequest
+from linebot.v3.messaging.models.coupon_others_reward_response import CouponOthersRewardResponse
+from linebot.v3.messaging.models.coupon_response import CouponResponse
+from linebot.v3.messaging.models.coupon_reward_request import CouponRewardRequest
+from linebot.v3.messaging.models.coupon_reward_response import CouponRewardResponse
 from linebot.v3.messaging.models.create_rich_menu_alias_request import CreateRichMenuAliasRequest
 from linebot.v3.messaging.models.datetime_picker_action import DatetimePickerAction
 from linebot.v3.messaging.models.demographic_filter import DemographicFilter
+from linebot.v3.messaging.models.discount_explicit_price_info_request import DiscountExplicitPriceInfoRequest
+from linebot.v3.messaging.models.discount_explicit_price_info_response import DiscountExplicitPriceInfoResponse
+from linebot.v3.messaging.models.discount_fixed_price_info_request import DiscountFixedPriceInfoRequest
+from linebot.v3.messaging.models.discount_fixed_price_info_response import DiscountFixedPriceInfoResponse
+from linebot.v3.messaging.models.discount_percentage_price_info_request import DiscountPercentagePriceInfoRequest
+from linebot.v3.messaging.models.discount_percentage_price_info_response import DiscountPercentagePriceInfoResponse
+from linebot.v3.messaging.models.discount_price_info_request import DiscountPriceInfoRequest
+from linebot.v3.messaging.models.discount_price_info_response import DiscountPriceInfoResponse
 from linebot.v3.messaging.models.emoji import Emoji
 from linebot.v3.messaging.models.emoji_substitution_object import EmojiSubstitutionObject
 from linebot.v3.messaging.models.error_detail import ErrorDetail
@@ -118,6 +151,8 @@
 from linebot.v3.messaging.models.limit import Limit
 from linebot.v3.messaging.models.location_action import LocationAction
 from linebot.v3.messaging.models.location_message import LocationMessage
+from linebot.v3.messaging.models.lottery_acquisition_condition_request import LotteryAcquisitionConditionRequest
+from linebot.v3.messaging.models.lottery_acquisition_condition_response import LotteryAcquisitionConditionResponse
 from linebot.v3.messaging.models.mark_messages_as_read_request import MarkMessagesAsReadRequest
 from linebot.v3.messaging.models.members_ids_response import MembersIdsResponse
 from linebot.v3.messaging.models.membership import Membership
@@ -128,9 +163,12 @@
 from linebot.v3.messaging.models.message_action import MessageAction
 from linebot.v3.messaging.models.message_imagemap_action import MessageImagemapAction
 from linebot.v3.messaging.models.message_quota_response import MessageQuotaResponse
+from linebot.v3.messaging.models.messaging_api_pager_coupon_list_response import MessagingApiPagerCouponListResponse
 from linebot.v3.messaging.models.multicast_request import MulticastRequest
 from linebot.v3.messaging.models.narrowcast_progress_response import NarrowcastProgressResponse
 from linebot.v3.messaging.models.narrowcast_request import NarrowcastRequest
+from linebot.v3.messaging.models.normal_acquisition_condition_request import NormalAcquisitionConditionRequest
+from linebot.v3.messaging.models.normal_acquisition_condition_response import NormalAcquisitionConditionResponse
 from linebot.v3.messaging.models.number_of_messages_response import NumberOfMessagesResponse
 from linebot.v3.messaging.models.operator_demographic_filter import OperatorDemographicFilter
 from linebot.v3.messaging.models.operator_recipient import OperatorRecipient
@@ -144,6 +182,7 @@
 from linebot.v3.messaging.models.quota_type import QuotaType
 from linebot.v3.messaging.models.recipient import Recipient
 from linebot.v3.messaging.models.redelivery_recipient import RedeliveryRecipient
+from linebot.v3.messaging.models.referral_acquisition_condition_response import ReferralAcquisitionConditionResponse
 from linebot.v3.messaging.models.reply_message_request import ReplyMessageRequest
 from linebot.v3.messaging.models.reply_message_response import ReplyMessageResponse
 from linebot.v3.messaging.models.rich_menu_alias_list_response import RichMenuAliasListResponse