Quick Start

5 分钟接入

下面这条最短路径会让你在 5 分钟内拿到第一个充值地址，并收到一笔模拟到账回调。

1. 注册沙箱账号

访问后台 → 应用列表 → 新增应用，会拿到 apiKey + apiSecret。 apiSecret 仅在创建时显示一次，请立即拷贝到密钥管理系统。

2. 给应用开通公链

在应用链订阅页选你需要的公链。前置条件：该公链必须先在「链分档配置」里被分档（运维 / 超管完成）。

3. 生成充值地址

签名串与 4 个 header 的算法见 HMAC 鉴权；下面演示已签好的请求形态（X-Signature 由签名算法算出）：

curl -X POST https://api.pqpa.com/api/v1/wallet/address/create \
  -H "X-Api-Key:    pk_test_xxx" \
  -H "X-Timestamp:  $(( $(date +%s) * 1000 ))" \
  -H "X-Nonce:      $(uuidgen | tr -d '-')" \
  -H "X-Signature:  $HMAC_SIG" \
  -H "Content-Type: application/json" \
  -d '{ "chainCode":"ETH", "externalUserId":"user_1024" }'

响应里的 data.address 就是该用户的专属充值地址，请持久化保存复用。完整字段见创建充值地址。

4. 配置回调地址

在管理后台为每个 bizType（充值 / 提现 / 归集等）分别配一个 https 回调 URL。回调的 payload 结构与验签算法见回调 Payload 与验签。

5. 收第一笔回调

在沙箱后台触发"模拟到账"，几秒内你的回调地址会收到一个 POST。验签通过后即接入完成。