PPQAPI
Getting Started

快速开始

接入 A 站只需要 Base URL、Site ID、API Secret 和 Webhook URL 四项信息。

1. 准备请求 Body

{
  "merchant_order_no": "ORDER202608200001",
  "amount": 289900,
  "currency": "CNY",
  "description": "Order payment"
}

amount 使用最小货币单位,例如 CNY 100 = ¥1.00。

2. 生成签名

X-Site-Id: YOUR_SITE_ID
X-Timestamp: 1787150000
X-Nonce: f640886a1ad24cb1
X-Signature: <64 lowercase hex chars>

签名原文:

timestamp + "\n" + nonce + "\n" + raw_body

3. 创建 Checkout Session

POST/api/v1/checkout-sessions

成功后读取 checkout.checkout_url 并把顾客 302 重定向过去。

4. 接收 Webhook

支付确认后,PQAPI 会向站点配置的 Webhook URL 发送 payment.paid。A 站必须验签并核对订单号、金额和币种后再更新业务订单。