Skip to content
Longport WhaleLongport Whale
Rewards

Claim IPO Fee Card

Claims the IPO fee card of the specified IPO for the user and returns the claimed card/voucher information. After claiming, the card can be selected directly in the current subscription to deduct the subscription handling fee. Use this only when the Get IPO Fee Card operation returns that the card can be claimed.

POSThttps://api.lbkrs.com/v1/reward/card/ipo/receive

Request body application/json

counter_idstringrequired

IPO security id, for example ST/HK/2636

currencystringrequired

Subscription currency, such as HKD

bz_typeintegerrequired

IPO subscription method, taken from the first value of the current subscription method bz_types: 1 financed IPO subscription, 2 cash IPO subscription

Values
1
2

Responses

HTTP 200The request succeeded. The response body contains the result of the “Claim IPO fee card” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
card_idstring

Card/voucher id. Pass it as cards[].card_id when submitting a subscription

card_typestring

Card/voucher type. For an IPO fee card, the value is ipo_commission

titlestring

Card/voucher title

title_secstring

Card/voucher subtitle

descriptionstring

Card/voucher description

detailstring

Card/voucher details

coverstring

Card/voucher cover image URL

backgroundstring

Card/voucher background image URL

stylestring

Card/voucher style

member_idstring

Holder id

start_timestring

Start time from which the card can be used, Unix timestamp (in seconds). "0" means not set

end_timestring

Expiry time, Unix timestamp (in seconds). "0" means not set

card_statusinteger

Card/voucher status:

  • 0: Unused
  • 1: Used
  • 2: Expired
  • 3: In use
Values
0
1
2
3
currencystring

Currency of the deduction amount

amountstring

Handling fee amount that can be deducted

bz_typesarray<integer>

IPO subscription types the card applies to: 1 financed IPO subscription, 2 cash IPO subscription

counter_idstring

IPO security id specified by the card. An empty string means no restriction

account_channelstring

Tenant channel to which the card applies

Whale Docs