获取购买

获取单笔购买交易的完整记录，包括 Provider、状态与交易 ID。

GET/v1/purchases/{purchase_id}

参数

参数	类型	位置	说明
`Authorization`必填	`string`	Header	Bearer {secret_key}
`purchase_id`必填	`string`	Path	购买 ID，如 pur_001。

请求示例

HTTP

GET /v1/purchases/pur_001 HTTP/1.1
Host: api.subhub.dev
Authorization: Bearer sk_live_neostudio_8f3k2m9x4l0p7q2r5s8u1v

响应示例

HTTP

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "pur_001",
  "member_id": "mem_001",
  "product_id": "prod_01PROMO",
  "provider": "apple",
  "status": "completed",
  "amount": 18,
  "currency": "CNY",
  "provider_transaction_id": "2000000123456789",
  "verified_at": "2026-06-27T18:32:01.800Z",
  "created_at": "2026-06-27T18:32:00.000Z",
  "updated_at": "2026-06-27T18:32:05.200Z"
}

代码示例

let url = URL(string: "https://api.subhub.dev/v1/purchases/pur_001")!
var request = URLRequest(url: url)
request.setValue("Bearer \(secretKey)", forHTTPHeaderField: "Authorization")