checkout API 参考 | AppointmentTrader

搜索所有端点

/v1/checkout/

GET

/v1/checkout/get_context

Public-by-design: same-origin guest payment preparation uses a session-bound anti-forgery token.

请求示例（cURL）

curl --get \
  'https://cn.appointmenttrader.com/v1/checkout/get_context' \
  --data-urlencode 'key={{API_KEY}}'

返回值

JSON

See the shared response schema and synthetic example.

响应字段

字段	类型	必填	描述
`$`	`checkout_get_context_Response`	`æ˜¯çš„`
`$.oneOf[0]`		`æ˜¯çš„`
`$.oneOf[0].allOf[0]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`否`
`$.oneOf[0].allOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.csrf`	`string`	`æ˜¯çš„`	Opaque anti-forgery token bound to the browser session. Synthetic examples never contain a usable token.
`$.oneOf[0].allOf[1].Payload.settings`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.settings.listing`	`boolean`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.settings.bid`	`boolean`	`æ˜¯çš„`
`$.oneOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[1].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[1].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`æ˜¯çš„`
`$.oneOf[1].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`否`

响应示例

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/get_context",
    "RequestUserAlias": "example-user",
    "Payload": {
        "csrf": "FAKE_CSRF_TOKEN",
        "settings": {
            "listing": false,
            "bid": false
        }
    }
}

机器可读的端点文档

GET

/v1/checkout/get_status

Public-by-design: only the originating browser or verified intended buyer can read this attempt.

参数

名称	类型	必填	默认值	描述
`attempt`	`string`	`æ˜¯çš„`	`—`	Opaque checkout attempt.

请求示例（cURL）

curl --get \
  'https://cn.appointmenttrader.com/v1/checkout/get_status' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}'

返回值

JSON

See the shared response schema and synthetic example.

响应字段

字段	类型	必填
`$`	`checkout_get_status_Response`	`æ˜¯çš„`
`$.oneOf[0]`		`æ˜¯çš„`
`$.oneOf[0].allOf[0]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`否`
`$.oneOf[0].allOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.attempt`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.state`	`string ["prepared","authorized","completing","completed","canceling","canceled","expired","recovery"]`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.paymentState`		`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[0]`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.paymentState.anyOf[1]`	`null`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.resultURL`		`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.resultURL.anyOf[0]`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.resultURL.anyOf[1]`	`null`	`æ˜¯çš„`
`$.oneOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[1].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[1].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`æ˜¯çš„`
`$.oneOf[1].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`否`

响应示例

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/get_status",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "state": "prepared",
        "paymentState": "requires_payment_method",
        "resultURL": "synthetic-example"
    }
}

机器可读的端点文档

POST

/v1/checkout/set_cancel

Public-by-design: cancellation requires the originating browser's token and attempt ownership.

参数

名称	类型	必填	默认值	描述
`attempt`	`string`	`æ˜¯çš„`	`—`	Opaque checkout attempt.
`csrf`	`string`	`æ˜¯çš„`	`—`	Browser token from get_context. POST required.

请求示例（cURL）

curl --request POST \
  'https://cn.appointmenttrader.com/v1/checkout/set_cancel' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'attempt={{attempt}}' \
  --data-urlencode 'csrf={{csrf}}'

返回值

JSON

See the shared response schema and synthetic example.

响应字段

字段	类型	必填
`$`	`checkout_set_cancel_Response`	`æ˜¯çš„`
`$.oneOf[0]`		`æ˜¯çš„`
`$.oneOf[0].allOf[0]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`否`
`$.oneOf[0].allOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload`	`= true`	`æ˜¯çš„`
`$.oneOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[1].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[1].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`æ˜¯çš„`
`$.oneOf[1].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`否`

响应示例

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/set_cancel",
    "RequestUserAlias": "example-user",
    "Payload": true
}

机器可读的端点文档

POST

/v1/checkout/set_prepare

Public-by-design: prepares a session-owned manual-capture payment; never purchases or creates a bid.

参数

名称	类型	必填	默认值	描述
`payloadJSON`	`string`	`æ˜¯çš„`	`—`	Listing UUID or canonical composer checkout fields and the selected reward.
`requestKey`	`string`	`æ˜¯çš„`	`—`	Random 64-character hexadecimal retry identity.
`csrf`	`string`	`æ˜¯çš„`	`—`	Browser token from get_context. POST required.

请求示例（cURL）

curl --request POST \
  'https://cn.appointmenttrader.com/v1/checkout/set_prepare' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'payloadJSON={{payloadJSON}}' \
  --data-urlencode 'requestKey={{requestKey}}' \
  --data-urlencode 'csrf={{csrf}}'

返回值

JSON

See the shared response schema and synthetic example.

参数: payloadJSON

字段	类型	必填	描述
`payloadJSON`	`string (application/json)`	`æ˜¯çš„`
`payloadJSON`	`GuestCheckoutPrepareInput (解码后的 JSON)`	`æ˜¯çš„`
`payloadJSON.oneOf[0]`	`object`	`æ˜¯çš„`
`payloadJSON.oneOf[0].listingUUID`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[0].expectedAmount`	`integer`	`æ˜¯çš„`
`payloadJSON.oneOf[1]`	`object`	`æ˜¯çš„`	Canonical fields must match the session-owned frozen composer snapshot. composersnapshot is an opaque token, not serialized request content. expectedAmount is the displayed total in USD cents; bidamount is the displayed principal in the active currency. Unknown fields are discarded.
`payloadJSON.oneOf[1].lid`	`DatabaseInteger`	`æ˜¯çš„`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].lid.oneOf[0]`	`integer`	`æ˜¯çš„`
`payloadJSON.oneOf[1].lid.oneOf[1]`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].inventorytypeid`	`DatabaseInteger`	`æ˜¯çš„`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].inventorytypeid.oneOf[0]`	`integer`	`æ˜¯çš„`
`payloadJSON.oneOf[1].inventorytypeid.oneOf[1]`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].unit`	`DatabaseInteger`	`æ˜¯çš„`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].unit.oneOf[0]`	`integer`	`æ˜¯çš„`
`payloadJSON.oneOf[1].unit.oneOf[1]`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].bidamount`	`DatabaseNumber`	`æ˜¯çš„`	Numeric value; MySQL reads can serialize numbers as numeric strings.
`payloadJSON.oneOf[1].bidamount.oneOf[0]`	`number`	`æ˜¯çš„`
`payloadJSON.oneOf[1].bidamount.oneOf[1]`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].startdate`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].enddate`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].starttime`	`string`	`否`
`payloadJSON.oneOf[1].enddtime`	`string`	`否`
`payloadJSON.oneOf[1].exactstarttime`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].exactendtime`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].cuidl`	`string`	`否`
`payloadJSON.oneOf[1].composersnapshot`	`string`	`æ˜¯çš„`
`payloadJSON.oneOf[1].atv2ComposerDraftInstanceKey`	`string`	`否`
`payloadJSON.oneOf[1].atv2ComposerDraftViewerKey`	`string`	`否`
`payloadJSON.oneOf[1].urid`	`DatabaseInteger`	`否`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].urid.oneOf[0]`	`integer`	`否`
`payloadJSON.oneOf[1].urid.oneOf[1]`	`string`	`否`
`payloadJSON.oneOf[1].composerurid`	`DatabaseInteger`	`否`	Integer value; legacy MySQL reads may serialize it as a numeric string.
`payloadJSON.oneOf[1].composerurid.oneOf[0]`	`integer`	`否`
`payloadJSON.oneOf[1].composerurid.oneOf[1]`	`string`	`否`
`payloadJSON.oneOf[1].premiumbid`		`否`	Presence selects the premium fee; omit entirely for standard pricing.
`payloadJSON.oneOf[1].premiumbid.anyOf[0]`	`string`	`否`
`payloadJSON.oneOf[1].premiumbid.anyOf[1]`	`boolean`	`否`
`payloadJSON.oneOf[1].premiumbid.anyOf[2]`	`integer`	`否`
`payloadJSON.oneOf[1].expectedAmount`	`integer`	`æ˜¯çš„`

响应字段

字段	类型	必填	描述
`$`	`checkout_set_prepare_Response`	`æ˜¯çš„`
`$.oneOf[0]`		`æ˜¯çš„`
`$.oneOf[0].allOf[0]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].RequestStatus`	`= "Succeeded"`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[0].allOf[0].RequestImpersonatedByUserAlias`	`string`	`否`
`$.oneOf[0].allOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload`	`object`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.attempt`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.expiresAt`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.serverTime`	`integer`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.flow`	`string ["listing","bid"]`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.resumeURL`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.clientSecret`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.paymentIntentID`	`string`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.paymentState`	`string ["requires_payment_method","requires_confirmation","requires_action","processing","requires_capture","canceled","succeeded"]`	`æ˜¯çš„`
`$.oneOf[0].allOf[1].Payload.amount`	`integer`	`æ˜¯çš„`	Total payable USD cents including the applicable publishing fee.
`$.oneOf[1]`	`object`	`æ˜¯çš„`
`$.oneOf[1].RequestUserAlias`	`string`	`æ˜¯çš„`
`$.oneOf[1].RequestPath`	`string \| null`	`æ˜¯çš„`
`$.oneOf[1].RequestStatus`	`= "Failed"`	`æ˜¯çš„`
`$.oneOf[1].ResponseCode`	`integer`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage`	`APIResponseMessage`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[0]`	`string \| number \| boolean \| null`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1]`	`array`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[1][]`	`APIResponseMessage`	`否`
`$.oneOf[1].ResponseMessage.oneOf[2]`	`object`	`æ˜¯çš„`
`$.oneOf[1].ResponseMessage.oneOf[2].*`	`APIResponseMessage`	`否`
`$.oneOf[1].RequestImpersonatedByUserAlias`	`string`	`否`

响应示例

{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/checkout/set_prepare",
    "RequestUserAlias": "example-user",
    "Payload": {
        "attempt": "synthetic-example",
        "expiresAt": 0,
        "serverTime": 0,
        "flow": "listing",
        "resumeURL": "synthetic-example",
        "clientSecret": "pi_FAKE_secret_PLACEHOLDER",
        "paymentIntentID": "pi_FAKE",
        "paymentState": "requires_payment_method",
        "amount": 0
    }
}

机器可读的端点文档