跳转到主要内容

​
概览

Waffo Pancake 中每次购买都会创建一个订单和一个关联的支付记录。订单代表客户的购买意图，而支付则跟踪实际的资金流动。

​
订单状态

订单根据产品类型有不同的状态集。

​
一次性订单

状态说明
pending订单已创建，等待支付
completed支付成功，订单已完成
canceled订单在完成前被取消

​
订阅订单

状态说明
pending订阅已创建，等待首次支付
active订阅处于活跃状态，正常计费
trialing客户处于免费试用期
past_due支付失败，正在重试
canceling已请求取消，在当前周期结束前仍保持活跃
canceled订阅已取消（在当前周期结束前仍可访问）
expired订阅已过期

​
支付状态

Pending

支付已发起，等待处理。

Processing

支付正在处理中。

Succeeded

支付已成功完成。

Failed

支付在处理过程中失败。

Refunded

已处理全额退款。

Partially Refunded

已处理部分退款。

​
支付列表

在表格中查看所有支付记录，包含以下列：
列说明
日期交易时间戳
金额支付金额（最小货币单位）
税额交易中收取的税费
状态当前支付状态
支付方式card、bank_transfer 或 wallet
客户客户邮箱地址
货币ISO 4217 货币代码

​
筛选

筛选条件选项
状态pending、processing、succeeded、failed、refunded、partially_refunded
日期范围自定义起止日期

​
支付详情

点击任意支付记录查看完整信息。

​
交易信息

字段说明
Payment IDUUID v4 标识符
Order ID关联订单
Store ID收款商店
Amount支付总额（最小货币单位）
CurrencyISO 4217 货币代码
Status当前支付状态
Created AtISO 8601 时间戳
Updated AtISO 8601 时间戳

​
金额详情

字段说明
amount总收费金额
taxAmount金额中的税费部分
settlementCurrency结算使用的货币
settlementAmount结算货币金额
refundedAmount已退款总额

​
账单信息

字段说明
country客户的账单国家
state账单州/地区
postcode账单邮编
isBusiness是否为企业购买
businessName企业名称（如适用）
taxId税号（如适用）

​
支付方式

支付记录会记载使用的支付方式：
方式值
信用卡/借记卡card
银行转账bank_transfer
数字钱包wallet
更多支付方式相关的详细信息可在 paymentMethodDetails 字段中获取。该字段的结构因支付方式而异。

​
支持的支付方式

银行卡

信用卡和借记卡支付。

银行转账

银行间直接转账。

钱包

数字钱包支付（Apple Pay、Google Pay 等）。

​
退款

退款请求通过单独的工单制工作流处理。买家提交退款工单，指定支付和原因，商家审核后批准或拒绝请求。
有关退款流程、状态和政策的完整详情，请参阅退款页面。
关键规则：
  • 一次性产品退款必须在支付后 7 天内申请
  • 订阅取消在当前计费周期结束时生效
  • 退款工单有自己的状态跟踪：pending、approved、rejected、processing、succeeded、failed

​
API 参考

​
创建订单

订单创建采用两步结账会话流程： 第一步：创建结账会话（API Key 或 Store Slug 认证） 
curl -X POST https://waffo-pancake-auth-service.vercel.app/v1/actions/checkout/create-session \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "store-uuid",
    "productId": "product-uuid",
    "productType": "onetime",
    "currency": "USD"
  }'
响应返回 sessionId 和 checkoutUrl。结账会话有 7 天有效期，会锁定产品版本和价格。 第二步：创建订单（API Key 认证） 
curl -X POST https://waffo-pancake-auth-service.vercel.app/v1/actions/onetime-order/create-order \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "checkoutSessionId": "session-uuid",
    "billingDetail": {
      "country": "US",
      "isBusiness": false,
      "state": "CA"
    }
  }'
两个端点都返回 checkoutUrl，买家应被重定向到该 URL 完成支付。

​
查询支付

使用 GraphQL 端点查询支付记录： 
query {
  payments(storeId: "store-uuid", limit: 20) {
    id
    orderId
    amount
    currency
    status
    paymentMethod
    amountDetails {
      amount
      taxAmount
      settlementCurrency
      settlementAmount
      refundedAmount
    }
    billingDetail {
      country
      state
      postcode
      isBusiness
      businessName
      taxId
    }
    createdAt
  }
}
所有金额均以最小货币单位表示。例如，USD 中的 2900 表示 $29.00。对于零小数货币如 JPY，4500 表示 4500 日元。