POST
/
merchant
/
discount
/
new
curl --request POST \
  --url https://api.unibee.top/merchant/discount/new \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "advance": true,
  "billingType": 123,
  "code": "<string>",
  "currency": "<string>",
  "cycleLimit": 123,
  "discountAmount": 123,
  "discountPercentage": 123,
  "discountType": 123,
  "endTime": 123,
  "metadata": {},
  "name": "<string>",
  "planApplyType": 123,
  "planIds": [
    123
  ],
  "quantity": 123,
  "startTime": 123,
  "upgradeLongPlanOnly": true,
  "upgradeOnly": true,
  "userLimit": 123,
  "userScope": 123
}'
{
  "code": 123,
  "data": {
    "discount": {
      "advance": true,
      "billingType": 123,
      "code": "<string>",
      "createTime": 123,
      "currency": "<string>",
      "cycleLimit": 123,
      "discountAmount": 123,
      "discountPercentage": 123,
      "discountType": 123,
      "endTime": 123,
      "id": 123,
      "isDeleted": 123,
      "merchantId": 123,
      "metadata": {},
      "name": "<string>",
      "planApplyType": 123,
      "planIds": [
        123
      ],
      "quantity": 123,
      "startTime": 123,
      "status": 123,
      "upgradeLongerOnly": true,
      "upgradeOnly": true,
      "userLimit": 123,
      "userScope": 123
    }
  },
  "message": "<string>",
  "redirect": "<string>",
  "requestId": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a new discount code, code can used in onetime or subscription purchase to make discount

​
billingType
integer
required

The billing type of the discount code, 1-one-time, 2-recurring, define the situation the code can be used, the code of one-time billing_type can used for all situation that effect only once, the code of recurring billing_tye can only used for subscription purchase

​
code
string
required

The discount's unique code, customize by merchant

​
discountType
integer
required

The discount type of the discount code, 1-percentage, 2-fixed_amount, the discountType of code, the discountPercentage will be effect when discountType is percentage, the discountAmount and currency will be effect when discountTYpe is fixed_amount

​
endTime
integer
required

The end time of discount code can effect, utc time

​
startTime
integer
required

The start time of discount code can effect, utc time

​
advance
boolean

AdvanceConfig, 0-false,1-true, will enable all advance config if set true

​
currency
string

The discount currency of discount code, available when discount_type is fixed_amount

​
cycleLimit
integer

The count limitation of subscription cycle, each subscription is valid separately , 0-no limit

​
discountAmount
integer

The discount amount of the discount code, available when discount_type is fixed_amount

​
discountPercentage
integer

The discount percentage of discount code, 100=1%, available when discount_type is percentage

​
metadata
object

Metadata，Map

​
name
string

The discount's name

​
planApplyType
integer

plan apply type, 0-apply for all, 1-apply for plans specified, 2-exclude for plans specified

​
planIds
integer[]

Ids of plan which discount code can effect, default effect all plans if not set

​
quantity
integer

Quantity of code, default 0, set 0 to disable quantity management

​
upgradeLongPlanOnly
boolean

AdvanceConfig, true or false, will forbid for all except upgrade to longer plan if set true

​
upgradeOnly
boolean

AdvanceConfig, true or false, will forbid for all except same interval upgrade action if set true

​
userLimit
integer

AdvanceConfig, The limit of every customer can apply, the recurring apply not involved, 0-unlimited

​
userScope
integer

AdvanceConfig, Apply user scope,0-for all, 1-for only new user, 2-for only renewals, renewals is upgrade&downgrade&renew

Response

200 - application/json
​
code
integer
​
data
object
​
message
string
​
redirect
string
​
requestId
string