POST /v1/proxy/{connector_code}/{path}
Baton 还没抽象的渠道私有能力,用这个口子直接打。我们只做两件事:
把金库 token 替换成真实卡数据、把请求签名后转发;响应原样返回,不做统一映射。
代价:透传的调用不进统一报表、不参与级联、不计入成功率口径。能用标准接口就别用它。
路径参数
connector_code必填 | string | |
path必填 | string | 渠道侧路径,原样拼接 |
请求头
Idempotency-Key必填 | string | 商户生成的唯一串(建议 UUID/ULID)。24 小时内重放同一 key 返回首次结果,不会产生第二笔。 |
X-Proxy-Method | POST | PUT | PATCH | DELETE | 转发到渠道时用的动词。我们自己的开放 API 只有 GET 和 POST;渠道要求 PUT / PATCH / DELETE 时用这个头指定,不传默认 POST |
请求
curl -X POST https://api.baton.example/v1/proxy/{connector_code}/{path} \
-H "Authorization: Bearer sk_live_xxx" \
-H "Idempotency-Key: 01J8ZQ4T7M2K9F3B" \
-H "X-Timestamp: 1763280000" -H "X-Nonce: 7f3a" -H "X-Signature: v1=..." \
-H "Content-Type: application/json" \
-d '{
"amount": {
"value": 8900,
"currency": "USD"
},
"paymentMethod": {
"type": "scheme",
"number": "{{pm_7c2a91f4.number}}"
}
}'