POST /v1/vault/methods/{token}/store
把一次性支付方式转成可复用 token,绑定到客户上。卡号不落你的库,也不落我们的业务库。
路径参数
请求头
Idempotency-Key必填 | string | 商户生成的唯一串(建议 UUID/ULID)。24 小时内重放同一 key 返回首次结果,不会产生第二笔。 |
请求体
响应 200
token | string | 金库引用。你的系统只应存这个值。 |
type | string | |
is_default | boolean | |
card_brand | string | |
card_last4 | string | |
card_exp_month | integer | |
card_exp_year | integer | |
network_token | boolean | 是否已升级为网络令牌(换卡不掉单) |
customer_uid | string | |
created_at | string<date-time> | |
请求
curl -X POST https://api.baton.example/v1/vault/methods/{token}/store \
-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 '{
"customer_uid": "CUS20261116000041"
}' POST /v1/vault/methods/{token}/default
路径参数
请求头
Idempotency-Key必填 | string | 商户生成的唯一串(建议 UUID/ULID)。24 小时内重放同一 key 返回首次结果,不会产生第二笔。 |
响应 200
token | string | 金库引用。你的系统只应存这个值。 |
type | string | |
is_default | boolean | |
card_brand | string | |
card_last4 | string | |
card_exp_month | integer | |
card_exp_year | integer | |
network_token | boolean | 是否已升级为网络令牌(换卡不掉单) |
customer_uid | string | |
created_at | string<date-time> | |
请求
curl -X POST https://api.baton.example/v1/vault/methods/{token}/default \
-H "Authorization: Bearer sk_live_xxx" \
-H "Idempotency-Key: 01J8ZQ4T7M2K9F3B" \
-H "X-Timestamp: 1763280000" -H "X-Nonce: 7f3a" -H "X-Signature: v1=..." POST /v1/vault/methods/{token}/delete
立即失效,但已发起的订阅扣款不受影响。删除动作进审计日志。
路径参数
响应 200
uid | string | |
deleted | boolean | |
请求
curl -X POST https://api.baton.example/v1/vault/methods/{token}/delete \
-H "Authorization: Bearer sk_live_xxx" \
-H "X-Timestamp: 1763280000" -H "X-Nonce: 7f3a" -H "X-Signature: v1=..."