创建价格

curl --request POST \ --url https://uat-api.clinkbill.com/api/price \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: <api-key>' \ --header 'X-Timestamp: <x-timestamp>' \ --data ' { "productId": "prd_xxxxx", "currency": "USD", "unitAmount": 29.99, "priceType": "recurring", "recurringDetails": { "interval": "month", "intervalCount": 1, "trialPeriodDays": 7, "pricingModel": "flat_rate" }, "isDefaultPrice": true } '

{ "code": 123, "msg": "<string>", "data": { "priceId": "<string>", "priceSnapshotId": "<string>", "productId": "<string>", "unitAmount": 123, "recurring": { "trialPeriodDays": 123, "transformQuantity": { "divideBy": 123 }, "intervalCount": 123 }, "active": true, "createTime": 123 } }

授权

X-API-KEY

string

header

必填

Your secret API key obtained from the Clink dashboard (Developers section)

请求头

X-Timestamp

string

必填

Current timestamp in milliseconds since Unix epoch (required for request signing)

示例:

"1783513683000"

请求体

application/json

Parameters required to create a price by API

productId

string

必填

Unique identifier of the product

currency

enum<string>

必填

Three-letter ISO currency code

可用选项:

USD,

EUR,

JPY,

GBP,

AUD,

CAD,

CNY,

HKD,

SGD,

KRW,

AED,

THB,

IDR,

PHP,

MYR,

BRL,

INR

unitAmount

number

必填

Unit amount for one-time or recurring base price

示例:

29.99

priceType

enum<string>

必填

Price type

可用选项:

one_time,

recurring

recurringDetails

object

Details of the Subscription

Show child attributes

priority

integer<int32>

Regional pricing priority. Lower values have higher priority.

isDefaultPrice

boolean

Whether this price should be the product default price

响应

Price created successfully

Body of the response message

code

integer<int32>

Response status code, 200 when success

msg

string

Brief description of what happened, 'success' when happy case

data

object

Show child attributes

概述

Checkout Session

Payment

Payment Instrument

Order

Agent Payment Session

Refund

Product

Price

Coupon

Promotion Code

Subscription

Test Clock

Customer Portal

Webhook Endpoint Management

Webhooks

授权

请求头

请求体

响应