● 渠道透传 · /v1

渠道透传

把你的原始请求转发给指定渠道,金库里的卡数据在转发时替换进去。用于 Baton 尚未抽象的渠道私有能力。

透传查询到渠道

GET /v1/proxy/{connector_code}/{path}

渠道的查询类私有接口(查订单、查退款状态)用这个。无请求体,无需幂等键。

路径参数

connector_code必填 string
path必填 string
请求
curl -X GET https://api.baton.example/v1/proxy/{connector_code}/{path} \
  -H "Authorization: Bearer sk_live_xxx"

透传到渠道

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}}"
  }
}'