{ "info": { "name": "Zise 开放 API", "description": "自 apidocs/openapi/*.yaml 生成。签名封在 collection 级的 pre-request script 里。\n先建环境变量：base_url / merchant_id / signing_key / token（换令牌拿）/ member_id。", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "// Zise 开放 API · 请求签名（五段串 + HMAC-SHA256）", "// 需要三个环境变量：base_url / merchant_id / signing_key，令牌用 {{token}}。", "const CryptoJS = require('crypto-js');", "const ts = Math.floor(Date.now() / 1000).toString(); // ⚠ 秒，不是毫秒", "const nonce = require('uuid').v4(); // ⚠ 每次换新", "const raw = pm.request.body && pm.request.body.raw ? pm.request.body.raw : '';", "// ⚠ 用原始文本算哈希，不要 JSON.parse 之后重新 stringify", "const bodyHash = CryptoJS.SHA256(raw).toString(CryptoJS.enc.Hex);", "const url = pm.request.url;", "// ⚠ PATH 必须含 query 一起进签名串（防同一份 body 被重放到另一个端点）", "const path = '/' + url.getPath().replace(/^//, '') + (url.getQueryString() ? '?' + url.getQueryString() : '');", "const base = [pm.request.method.toUpperCase(), path, ts, nonce, bodyHash].join('\\n');", "// ⚠ 签名是 Base64，而上面 body 的哈希是 Hex —— 两段编码不同，别写成一样的", "const sig = CryptoJS.HmacSHA256(base, pm.environment.get('signing_key')).toString(CryptoJS.enc.Base64);", "pm.request.headers.upsert({ key: 'x-timestamp', value: ts });", "pm.request.headers.upsert({ key: 'x-nonce', value: nonce });", "pm.request.headers.upsert({ key: 'x-signature', value: sig });" ] } } ], "item": [ { "name": "账户中心（Account Center）", "item": [ { "name": "令牌", "item": [ { "name": "POST /v1/connect/token", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/connect/token", "host": [ "{{base_url}}" ], "path": [ "v1", "connect", "token" ] }, "description": "换取访问令牌\n\nScope: —\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/connect-token" } } ] }, { "name": "商户账户", "item": [ { "name": "GET /v1/merchant", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant" ] }, "description": "商户资料、被授权产品、生效限额\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-merchant" } }, { "name": "GET /v1/merchant/balances", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/balances", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "balances" ] }, "description": "商户资金账户（可用 / 冻结 / 待结算 / 托管声明）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-merchant-balances" } }, { "name": "GET /v1/merchant/lines", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/lines", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "lines" ] }, "description": "本商户开通了哪几条业务线（含低水位自动停售状态）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-lines" } }, { "name": "GET /v1/merchant/pending", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/pending", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "pending" ] }, "description": "因预付不足而排队的订单（笔数 / 逐资产 / 最早一笔）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-pending" } }, { "name": "GET /v1/merchant/statements", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/statements", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "statements" ] }, "description": "业务扣款记录（每单最终从预付扣了多少）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-statements" } }, { "name": "GET /v1/merchant/custody", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/custody", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "custody" ] }, "description": "托管核对（balanced=false = 有余额没有你的声明背书）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/reconcile-custody" } }, { "name": "GET /v1/merchant/deposit-addresses", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/deposit-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "deposit-addresses" ] }, "description": "预付充值地址清单\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-deposit-addresses" } }, { "name": "POST /v1/merchant/deposit-addresses", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/merchant/deposit-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "deposit-addresses" ] }, "description": "申请预付充值地址（按 币×网络 复用）\n\nScope: merchant:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-merchant-deposit-address", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"network\": \"TRC20\"\n}" } } }, { "name": "GET /v1/merchant/payout-addresses", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/payout-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "payout-addresses" ] }, "description": "你的提现地址簿（只读，没有 POST）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-payout-addresses" } }, { "name": "GET /v1/merchant/payouts", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/payouts", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "payouts" ] }, "description": "你提过的提现单（只读，没有发起口）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-payouts" } }, { "name": "GET /v1/merchant/topups", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/topups", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "topups" ] }, "description": "预付充值单（链上到账 + 线下结算两条腿）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-merchant-topups" } }, { "name": "POST /v1/merchant/topups", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/merchant/topups", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "topups" ] }, "description": "申报一笔预付充值（主要用于线下结算）\n\nScope: merchant:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-merchant-topup", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"channel\": \"fiat\",\n \"amount\": \"50000.00\",\n \"reference_no\": \"TT20260813001\",\n \"note\": \"8 月备付金\"\n}" } } } ] }, { "name": "会员", "item": [ { "name": "GET /v1/members", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/members", "host": [ "{{base_url}}" ], "path": [ "v1", "members" ] }, "description": "会员列表（游标分页）\n\nScope: members:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-members" } }, { "name": "POST /v1/members", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/members", "host": [ "{{base_url}}" ], "path": [ "v1", "members" ] }, "description": "建会员\n\nScope: members:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-member", "body": { "mode": "raw", "raw": "{\n \"external_member_id\": \"u-10086\",\n \"email\": \"alice@example.com\"\n}" } } }, { "name": "GET /v1/members/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/members/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}" ] }, "description": "会员详情（KYC 层级、处置态）\n\nScope: members:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-member" } }, { "name": "PATCH /v1/members/{id}", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/members/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}" ] }, "description": "改商户侧属性（昵称、语言）\n\nScope: members:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/update-member", "body": { "mode": "raw", "raw": "{\n \"nickname\": \"Alice\",\n \"notify_lang\": \"zh-Hans\"\n}" } } }, { "name": "POST /v1/members/{id}/suspend", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/members/{id}/suspend", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}", "suspend" ] }, "description": "商户级停用（不影响该人在其他商户）\n\nScope: members:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/suspend-member", "body": { "mode": "raw", "raw": "{\n \"suspended\": false\n}" } } }, { "name": "POST /v1/members/{id}/email-sessions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/members/{id}/email-sessions", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}", "email-sessions" ] }, "description": "换绑账号邮箱 —— 换一张托管屏链接\n\nScope: members:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-member-email-session" } }, { "name": "POST /v1/members/{id}/sessions/revoke", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/members/{id}/sessions/revoke", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}", "sessions", "revoke" ] }, "description": "强制会员下线（不是封禁，可立刻重登）\n\nScope: members:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/revoke-member-sessions" } }, { "name": "GET /v1/members/{id}/limits", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/members/{id}/limits", "host": [ "{{base_url}}" ], "path": [ "v1", "members", "{id}", "limits" ] }, "description": "该会员的额度占用（只读，不下发上限）\n\nScope: members:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-member-limits" } } ] }, { "name": "实名", "item": [ { "name": "GET /v1/kyc", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/kyc", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc" ] }, "description": "KYC 结论（level + 最小字段，无影像、无档案）\n\nScope: kyc:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-kyc" } }, { "name": "POST /v1/kyc/profile-sessions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/profile-sessions", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "profile-sessions" ] }, "description": "实名档案更新 —— 换一张托管屏链接\n\nScope: kyc:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-kyc-profile-session" } }, { "name": "GET /v1/kyc/requirements", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/requirements", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "requirements" ] }, "description": "各业务线要求的 KYC 层级\n\nScope: kyc:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-kyc-requirements" } }, { "name": "POST /v1/kyc/sessions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/kyc/sessions", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "sessions" ] }, "description": "发起一次 L1 实名（我方托管屏，返回一条链接）\n\nScope: kyc:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-kyc-session", "body": { "mode": "raw", "raw": "{}" } } }, { "name": "POST /v1/kyc/l2/sessions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/kyc/l2/sessions", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "l2", "sessions" ] }, "description": "换一条 L2 进阶认证的托管屏链接\n\nScope: kyc:write\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-kyc-l2-session", "body": { "mode": "raw", "raw": "{}" } } }, { "name": "GET /v1/kyc/supplements", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/supplements", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "supplements" ] }, "description": "待补件请求与我方托管的填写链接\n\nScope: kyc:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-kyc-supplements" } } ] }, { "name": "Webhook", "item": [ { "name": "GET /v1/webhooks/deliveries", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/webhooks/deliveries", "host": [ "{{base_url}}" ], "path": [ "v1", "webhooks", "deliveries" ] }, "description": "Webhook 投递记录（不含 payload）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-webhook-deliveries" } }, { "name": "POST /v1/webhooks/deliveries/{id}/redeliver", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/webhooks/deliveries/{id}/redeliver", "host": [ "{{base_url}}" ], "path": [ "v1", "webhooks", "deliveries", "{id}", "redeliver" ] }, "description": "重投（只有 dead / failed / no_subscriber 可重投）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/redeliver-webhook" } } ] }, { "name": "资产目录", "item": [ { "name": "GET /v1/assets", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/assets", "host": [ "{{base_url}}" ], "path": [ "v1", "assets" ] }, "description": "资产白名单、精度，以及每条链的机读网络码\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-assets" } } ] }, { "name": "报表导出", "item": [ { "name": "GET /v1/reports", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/reports", "host": [ "{{base_url}}" ], "path": [ "v1", "reports" ] }, "description": "我的导出任务列表\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-report-exports" } }, { "name": "POST /v1/reports", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/reports", "host": [ "{{base_url}}" ], "path": [ "v1", "reports" ] }, "description": "建一个对账报表导出任务（异步 · 出 CSV）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/create-report-export", "body": { "mode": "raw", "raw": "{\n \"kind\": \"statements\",\n \"days\": 30\n}" } } }, { "name": "GET /v1/reports/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/reports/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "reports", "{id}" ] }, "description": "单个导出任务的状态（这是轮询口）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/get-report-export" } }, { "name": "GET /v1/reports/{id}/content", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/reports/{id}/content", "host": [ "{{base_url}}" ], "path": [ "v1", "reports", "{id}", "content" ] }, "description": "取导出件（响应体是 CSV，不是 JSON）\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/download-report-export" } } ] }, { "name": "沙盒", "item": [ { "name": "POST /v1/sandbox/faucet", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/sandbox/faucet", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "faucet" ] }, "description": "沙盒 · 给你的沙盒预付账户补钱\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/sandbox-faucet\n\n⚠ 这个端点会动钱：增商户预付 available（对手方 custody.settled）", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"amount\": \"500.000000\"\n}" } } }, { "name": "GET /v1/sandbox/upstream-behaviors", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/sandbox/upstream-behaviors", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "upstream-behaviors" ] }, "description": "沙盒 · 当前为各条业务线预置了什么行为\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/list-sandbox-behaviors" } }, { "name": "POST /v1/sandbox/upstream-behavior", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/sandbox/upstream-behavior", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "upstream-behavior" ] }, "description": "沙盒 · 预置某家上游的返回行为\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/set-sandbox-behavior", "body": { "mode": "raw", "raw": "{\n \"upstream\": \"qrpay\",\n \"behavior\": \"unknown\"\n}" } } }, { "name": "POST /v1/sandbox/reset", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/sandbox/reset", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "reset" ] }, "description": "沙盒 · 清掉投递记录与调用日志\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/account-center/v1/api-reference/reset-sandbox" } } ] } ] }, { "name": "全球账户（Global Account）", "item": [ { "name": "走廊与汇率", "item": [ { "name": "GET /v1/remit/corridors", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/corridors", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "corridors" ] }, "description": "可用走廊（按商户授权过滤）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-remit-corridors" } }, { "name": "GET /v1/remit/rates", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/rates", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "rates" ] }, "description": "牌价（不建单、不要收款人）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-remit-rates" } }, { "name": "GET /v1/remit/conversion-dates", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/conversion-dates", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "conversion-dates" ] }, "description": "可交割日（「几号到」的预告）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-remit-conversion-dates" } }, { "name": "GET /v1/remit/swift-search", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/swift-search", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "swift-search" ] }, "description": "银行目录搜索（BIC / 行名 → 行名 + 地址）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/search-remit-swift" } } ] }, { "name": "收款人", "item": [ { "name": "GET /v1/remit/payee-form-schema", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/payee-form-schema", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payee-form-schema" ] }, "description": "该走廊要填哪些字段（先验走廊再给表单）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-payee-form-schema" } }, { "name": "GET /v1/remit/payees", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remit/payees", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees" ] }, "description": "收款人列表（含 name_mismatch 风控位）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-payees" } }, { "name": "POST /v1/remit/payees", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remit/payees", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees" ] }, "description": "新建或关联收款人（建档不碰上游）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/create-payee", "body": { "mode": "raw", "raw": "{\n \"country_code\": \"GB\",\n \"currency\": \"GBP\",\n \"payment_method\": \"LOCAL\",\n \"clearing_system\": \"FASTER PAYMENTS\",\n \"entity_type\": \"INDIVIDUAL\",\n \"nickname\": \"房东\",\n \"fields\": {\n \"first_name\": \"MARY\",\n \"last_name\": \"SMITH\",\n \"bank_details.account_holder\": \"MARY SMITH\",\n \"bank_details.bank_name\": \"Barclays\",\n \"bank_details.bank_address\": \"1 Churchill Place, London\",\n \"bank_details.swift_code\": \"BUKBGB22\",\n \"bank_details.iban\": \"GB33BUKB20201555555555\",\n \"bank_details.routing_code_value1\": \"202015\",\n \"bank_details.routing_code_type1\": \"sort_code\",\n \"address.country\": \"GB\",\n \"address.state\": \"Greater London\",\n \"address.city\": \"London\",\n \"address.street_address\": \"221B Baker Street\",\n \"address.postal_code\": \"NW1 6XE\"\n }\n}" } } }, { "name": "GET /v1/remit/payees/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remit/payees/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees", "{id}" ] }, "description": "单条收款人（含 upstream_status）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-payee" } }, { "name": "PATCH /v1/remit/payees/{id}", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remit/payees/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees", "{id}" ] }, "description": "改收款人的备注名 / 收藏（只能改这两项）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/update-remit-payee", "body": { "mode": "raw", "raw": "{\n \"nickname\": \"房东\",\n \"favorite\": true\n}" } } }, { "name": "DELETE /v1/remit/payees/{id}", "request": { "method": "DELETE", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remit/payees/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees", "{id}" ] }, "description": "解除关联（删的是关联不是主体）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/delete-payee" } }, { "name": "POST /v1/remit/payees/{id}/verify", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remit/payees/{id}/verify", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "payees", "{id}", "verify" ] }, "description": "提前把收款人送去上游建档（不动一分钱）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/verify-payee" } } ] }, { "name": "报价", "item": [ { "name": "GET /v1/remit/products", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/products", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "products" ] }, "description": "汇款两条线的下单前置（用途码 / 滑点 / 最低起汇额 / 限额）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-remit-products" } }, { "name": "POST /v1/remit/quotes", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remit/quotes", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "quotes" ] }, "description": "汇款试算（不建单不冻结；必读 applied_rate）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/create-remit-quote", "body": { "mode": "raw", "raw": "{\n \"payee_id\": \"pye_1042\",\n \"line\": \"express\",\n \"asset\": \"USDT\",\n \"payout_amount\": \"380.00\"\n}" } } } ] }, { "name": "汇款单", "item": [ { "name": "GET /v1/remittances/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remittances/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances", "{id}" ] }, "description": "汇款订单详情\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-remittance" } }, { "name": "GET /v1/remit/vp/agreement", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/remit/vp/agreement", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "vp", "agreement" ] }, "description": "个人汇款开户协议正文（六语言 · 提交前必须让用户读到）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-vp-agreement" } }, { "name": "GET /v1/remit/vp/applications", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remit/vp/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "vp", "applications" ] }, "description": "查个人线开户进度\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-vp-application" } }, { "name": "POST /v1/remit/vp/applications", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remit/vp/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "remit", "vp", "applications" ] }, "description": "提交个人线（POBO）开户申请\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/create-vp-application", "body": { "mode": "raw", "raw": "{}" } } }, { "name": "GET /v1/remittances", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remittances", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances" ] }, "description": "汇款订单列表\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-remittances" } }, { "name": "POST /v1/remittances", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remittances", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances" ] }, "description": "下单（付款重试沿用同一把幂等键）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/create-remittance\n\n⚠ 这个端点会动钱：冻结会员该资产的可用余额（locked_amount，含滑点预留）+ 同步冻结你的预付备付金", "body": { "mode": "raw", "raw": "{\n \"payee_id\": \"pye_1042\",\n \"payout_amount\": \"380.00\",\n \"slippage_bps\": 100,\n \"purpose_code\": \"FAMILY_SUPPORT\",\n \"reference\": \"Rent Aug\",\n \"line\": \"express\",\n \"asset\": \"USDT\"\n}" } } }, { "name": "POST /v1/remittances/{id}/cancel", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remittances/{id}/cancel", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances", "{id}", "cancel" ] }, "description": "取消（只有 needs_reconfirm 可撤）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/cancel-remittance\n\n⚠ 这个端点会动钱：解冻会员的 locked 并退回可用余额（含此前每一轮补冻），同步释放你的预付冻结", "body": { "mode": "raw", "raw": "{}" } } }, { "name": "POST /v1/remittances/{id}/reconfirm", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/remittances/{id}/reconfirm", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances", "{id}", "reconfirm" ] }, "description": "接受涨价并补冻（4 小时时效）\n\nScope: remittances:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/reconfirm-remittance\n\n⚠ 这个端点会动钱：补冻差额（extra_locked）进 locked 桶，并同步补冻你的预付备付金", "body": { "mode": "raw", "raw": "{\n \"accept_total\": \"512.340000\"\n}" } } }, { "name": "GET /v1/remittances/{id}/pending-action", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/remittances/{id}/pending-action", "host": [ "{{base_url}}" ], "path": [ "v1", "remittances", "{id}", "pending-action" ] }, "description": "这单在等用户做什么（重新确认 / 补件 / 无）\n\nScope: remittances:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/get-remittance-pending-action" } } ] }, { "name": "商户换汇", "item": [ { "name": "GET /v1/merchant/conversion-pairs", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/conversion-pairs", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "conversion-pairs" ] }, "description": "预付资产内部调剂 · 可换的方向与当前参考价\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-merchant-conversion-pairs" } }, { "name": "GET /v1/merchant/conversions", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/merchant/conversions", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "conversions" ] }, "description": "内部调剂的成交记录\n\nScope: merchant:read\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/list-merchant-conversions" } }, { "name": "POST /v1/merchant/conversions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/merchant/conversions", "host": [ "{{base_url}}" ], "path": [ "v1", "merchant", "conversions" ] }, "description": "预付资产内部调剂（原子 · 不可逆 · 无中间态）\n\nScope: merchant:write\n文档：https://docs.zinfra.vip/global-account/v1/api-reference/create-merchant-conversion\n\n⚠ 这个端点会动钱：你的预付：扣 from 资产 / 增 to 资产（同一名下，逐资产各自平）", "body": { "mode": "raw", "raw": "{\n \"from_asset\": \"USDT\",\n \"to_asset\": \"USDC\",\n \"from_amount\": \"5000.000000\",\n \"min_to_amount\": \"4990.000000\"\n}" } } } ] } ] }, { "name": "全球收单（Global Acquiring）", "item": [ { "name": "扫码付", "item": [ { "name": "GET /v1/qrpay/orders/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/qrpay/orders/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "orders", "{id}" ] }, "description": "扫码付订单详情\n\nScope: qrpay:read\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/get-qrpay-order" } }, { "name": "GET /v1/qrpay/config", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/qrpay/config", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "config" ] }, "description": "扫码付只读配置（可付资产 · 余额 · 费率 · 限额）\n\nScope: qrpay:read\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/get-qrpay-config" } }, { "name": "POST /v1/qrpay/decode", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/qrpay/decode", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "decode" ] }, "description": "解码收款码（纯读，不建单不锁钱）\n\nScope: qrpay:write\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/decode-qr-code", "body": { "mode": "raw", "raw": "{\n \"code_value\": \"00020101021229300012D156000000000510A93FO3230Q...\"\n}" } } }, { "name": "POST /v1/qrpay/quotes", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/qrpay/quotes", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "quotes" ] }, "description": "报价（收银台确认页的数字；建上游待支付单，不锁钱）\n\nScope: qrpay:write\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/create-qrpay-quote", "body": { "mode": "raw", "raw": "{\n \"code_value\": \"00020101021229300012D156000000000510A93FO3230Q...\",\n \"currency\": \"THB\",\n \"amount\": \"250.00\",\n \"payer\": {\n \"custName\": \"CHAN TAI MAN\",\n \"legalId\": \"A1234567\"\n }\n}" } } }, { "name": "POST /v1/qrpay/payments", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/qrpay/payments", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "payments" ] }, "description": "扫码付款（先锁钱再放行；processing = 结果不明，等 webhook）\n\nScope: qrpay:write\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/create-qrpay-payment\n\n⚠ 这个端点会动钱：锁定会员该资产的可用余额（先锁钱，再通知上游放行）", "body": { "mode": "raw", "raw": "{\n \"code_value\": \"00020101021229300012D156000000000510A93FO3230Q...\",\n \"currency\": \"THB\",\n \"amount\": \"250.00\",\n \"preferred_asset\": \"USDT\",\n \"payer\": {\n \"custName\": \"CHAN TAI MAN\",\n \"legalId\": \"A1234567\"\n }\n}" } } }, { "name": "GET /v1/qrpay/orders", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/qrpay/orders", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "orders" ] }, "description": "扫码付订单列表\n\nScope: qrpay:read\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/list-qrpay-orders" } }, { "name": "GET /v1/qrpay/schemes", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/qrpay/schemes", "host": [ "{{base_url}}" ], "path": [ "v1", "qrpay", "schemes" ] }, "description": "可用码制（随上游同步，不是静态常量）\n\nScope: qrpay:read\n文档：https://docs.zinfra.vip/global-acquiring/v1/api-reference/list-qrpay-schemes" } } ] } ] }, { "name": "卡发行（Card Issuance）", "item": [ { "name": "卡产品", "item": [ { "name": "GET /v1/cards/products", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/cards/products", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "products" ] }, "description": "可申请的卡产品（按商户授权的 BIN 过滤）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/list-card-products" } }, { "name": "GET /v1/cards/products/{id}/quote", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/products/{id}/quote", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "products", "{id}", "quote" ] }, "description": "开卡发票 —— 这一款卡对这个会员的报价与准入\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/quote-card-product" } } ] }, { "name": "开卡申请", "item": [ { "name": "POST /v1/cards/applications", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications" ] }, "description": "提交开卡申请（虚拟/实体经 form_factor 区分）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-card-application\n\n⚠ 这个端点会动钱：扣开卡费与邮费 + 锁定首充金额（会员可用余额）", "body": { "mode": "raw", "raw": "{\n \"form_factor\": \"virtual\",\n \"product_id\": \"cpd_1042\",\n \"source_asset\": \"USDT\",\n \"first_topup\": \"50.00\",\n \"client_key\": \"6d0f3a2e-8b41-4c77-9a10-2f5c7e91b3d4\"\n}" } } }, { "name": "GET /v1/cards/applications/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}" ] }, "description": "申请状态\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-card-application" } }, { "name": "GET /v1/cards/applications/{id}/cancel-preview", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}/cancel-preview", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "cancel-preview" ] }, "description": "取消预览（能不能取消 · 退多少）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/preview-card-application-cancel" } }, { "name": "POST /v1/cards/applications/{id}/cancel", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}/cancel", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "cancel" ] }, "description": "取消申请（唯一的自助止损路径）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/cancel-card-application\n\n⚠ 这个端点会动钱：按阶段把开卡费与邮费退回该会员的可用余额", "body": { "mode": "raw", "raw": "{\n \"reason\": \"user_changed_mind\"\n}" } } }, { "name": "POST /v1/cards/applications/{id}/supplement-sessions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}/supplement-sessions", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "supplement-sessions" ] }, "description": "补件 —— 换一张托管屏链接给终端用户\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-card-supplement-session" } }, { "name": "GET /v1/cards/applications/{id}/shipment", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}/shipment", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "shipment" ] }, "description": "实体卡物流（四条状态轴之一，不由其余派生）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-card-shipment" } } ] }, { "name": "卡片", "item": [ { "name": "GET /v1/cards", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards", "host": [ "{{base_url}}" ], "path": [ "v1", "cards" ] }, "description": "卡列表（前六后四，永不含完整卡号）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/list-cards" } }, { "name": "GET /v1/cards/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}" ] }, "description": "卡详情（前六后四，永不含完整卡号）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-card" } }, { "name": "PATCH /v1/cards/{id}", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}" ] }, "description": "改卡备注名\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/update-card", "body": { "mode": "raw", "raw": "{\n \"nickname\": \"差旅卡\"\n}" } } }, { "name": "GET /v1/cards/{id}/transactions", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/transactions", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "transactions" ] }, "description": "卡消费流水（游标分页）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/list-card-transactions" } } ] }, { "name": "卡内资金", "item": [ { "name": "POST /v1/cards/{id}/topup-quotes", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/topup-quotes", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "topup-quotes" ] }, "description": "充值到卡试算（不外呼上游）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/quote-card-topup", "body": { "mode": "raw", "raw": "{\n \"amount\": \"100.00\",\n \"source_asset\": \"USDT\"\n}" } } }, { "name": "POST /v1/cards/{id}/topups", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/topups", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "topups" ] }, "description": "充值到卡（两段异步：到卡以 webhook 为准）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-card-topup\n\n⚠ 这个端点会动钱：扣会员源资产可用余额 + 冻结商户预付；到卡由 webhook 确认", "body": { "mode": "raw", "raw": "{\n \"amount\": \"100.00\",\n \"source_asset\": \"USDT\"\n}" } } }, { "name": "POST /v1/cards/{id}/withdrawals", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/withdrawals", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "withdrawals" ] }, "description": "卡内资金转出到钱包（≠ 链上提现）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-card-withdrawal\n\n⚠ 这个端点会动钱：卡内资金（`member.card` 桶）→ 会员可用余额；手续费按产品配置", "body": { "mode": "raw", "raw": "{\n \"amount\": \"10.50\"\n}" } } } ] }, { "name": "消费管控", "item": [ { "name": "POST /v1/cards/{id}/freeze", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/freeze", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "freeze" ] }, "description": "冻结卡片（过渡态 freezing）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/freeze-card" } }, { "name": "POST /v1/cards/{id}/unfreeze", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/unfreeze", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "unfreeze" ] }, "description": "解冻卡片（过渡态 unfreezing，与冻结分开的端点）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/unfreeze-card" } }, { "name": "PATCH /v1/cards/{id}/limits", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/limits", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "limits" ] }, "description": "设置用户自定义限额（0 = 未自设，落到产品上限）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/set-card-limits", "body": { "mode": "raw", "raw": "{\n \"single\": \"500.00\",\n \"daily\": \"2000.00\",\n \"monthly\": \"10000.00\"\n}" } } }, { "name": "GET /v1/cards/{id}/merchant-rules", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/merchant-rules", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "merchant-rules" ] }, "description": "读这张卡的商户 / MCC 名单\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-card-merchant-rules" } }, { "name": "PUT /v1/cards/{id}/merchant-rules", "request": { "method": "PUT", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/merchant-rules", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "merchant-rules" ] }, "description": "整份替换商户 / MCC 名单（白名单或黑名单，二选一）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/set-card-merchant-rules", "body": { "mode": "raw", "raw": "{\n \"rule_type\": \"black\",\n \"merchant_names\": [],\n \"mcc_list\": [\n \"7995\",\n \"5967\",\n \"6051\"\n ]\n}" } } }, { "name": "DELETE /v1/cards/{id}/merchant-rules", "request": { "method": "DELETE", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/merchant-rules", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "merchant-rules" ] }, "description": "清空这张卡的名单（恢复成不受限）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/clear-card-merchant-rules" } }, { "name": "PATCH /v1/cards/{id}/billing-address", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/billing-address", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "billing-address" ] }, "description": "改账单地址（美国线上商户 AVS 校验的对象）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/update-card-billing-address", "body": { "mode": "raw", "raw": "{\n \"address\": \"1600 Amphitheatre Pkwy\",\n \"city\": \"Mountain View\",\n \"state\": \"CA\",\n \"country\": \"US\",\n \"postal_code\": \"94043\"\n}" } } } ] }, { "name": "生命周期", "item": [ { "name": "GET /v1/cards/{id}/replacement", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/replacement", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "replacement" ] }, "description": "补卡进度与补卡报价（互斥的两块）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-card-replacement" } }, { "name": "POST /v1/cards/{id}/lost", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/lost", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "lost" ] }, "description": "挂失 / 报盗卡（不可逆，仅实体卡）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/report-card-lost-or-stolen", "body": { "mode": "raw", "raw": "{\n \"kind\": \"stolen\"\n}" } } }, { "name": "GET /v1/cards/{id}/close-check", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/close-check", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "close-check" ] }, "description": "销卡预检（必须先清空卡内资金）\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/check-card-close" } }, { "name": "POST /v1/cards/{id}/close", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/close", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "close" ] }, "description": "销卡（不可逆）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/close-card", "body": { "mode": "raw", "raw": "{\n \"reason\": \"用户不再需要\"\n}" } } }, { "name": "POST /v1/cards/{id}/replacements", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/replacements", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "replacements" ] }, "description": "补/换卡申请（余额不在新旧卡之间直接转）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/request-card-replacement", "body": { "mode": "raw", "raw": "{\n \"reason\": \"pan_leaked\",\n \"note\": \"用户报告卡号在钓鱼站被输入\"\n}" } } } ] }, { "name": "实体卡", "item": [ { "name": "POST /v1/cards/bind", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/bind", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "bind" ] }, "description": "绑定实体卡（三要素；不挂强认证）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/bind-physical-card", "body": { "mode": "raw", "raw": "{\n \"pan\": \"5240121234567890\",\n \"expiry\": \"08/29\",\n \"cvv\": \"123\"\n}" } } }, { "name": "POST /v1/cards/{id}/activate", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/activate", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "activate" ] }, "description": "激活实体卡（挂强认证且不可逆）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/activate-card", "body": { "mode": "raw", "raw": "{\n \"expiry\": \"08/29\",\n \"pin\": \"1234\"\n}" } } }, { "name": "POST /v1/cards/{id}/pin", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/pin", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "pin" ] }, "description": "改 / 重置 PIN（忘了旧 PIN 走 CVV 那一支）\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/set-card-pin", "body": { "mode": "raw", "raw": "{\n \"cvv\": \"123\",\n \"new_pin\": \"4821\"\n}" } } } ] }, { "name": "邮寄地址簿", "item": [ { "name": "GET /v1/shipping-addresses", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses" ] }, "description": "邮寄地址簿\n\nScope: addresses:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/list-shipping-addresses" } }, { "name": "POST /v1/shipping-addresses", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses" ] }, "description": "新增邮寄地址\n\nScope: addresses:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-shipping-address", "body": { "mode": "raw", "raw": "{\n \"label\": \"家\",\n \"country\": \"HK\",\n \"recipient_last\": \"陈\",\n \"recipient_first\": \"小明\",\n \"phone_code\": \"852\",\n \"phone_number\": \"51234567\",\n \"city\": \"香港\",\n \"district\": \"中西区\",\n \"line1\": \"干诺道中 200 号\",\n \"postal_code\": \"000000\",\n \"is_default\": true\n}" } } }, { "name": "GET /v1/shipping-addresses/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses", "{id}" ] }, "description": "单条地址\n\nScope: addresses:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/get-shipping-address" } }, { "name": "PATCH /v1/shipping-addresses/{id}", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses", "{id}" ] }, "description": "修改地址内容\n\nScope: addresses:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/update-shipping-address", "body": { "mode": "raw", "raw": "{\n \"country\": \"HK\",\n \"recipient_last\": \"陈\",\n \"recipient_first\": \"小明\",\n \"phone_code\": \"852\",\n \"phone_number\": \"51234567\",\n \"city\": \"香港\",\n \"line1\": \"皇后大道中 15 号\",\n \"postal_code\": \"000000\"\n}" } } }, { "name": "DELETE /v1/shipping-addresses/{id}", "request": { "method": "DELETE", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses", "{id}" ] }, "description": "删除地址\n\nScope: addresses:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/delete-shipping-address" } }, { "name": "POST /v1/shipping-addresses/{id}/default", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/shipping-addresses/{id}/default", "host": [ "{{base_url}}" ], "path": [ "v1", "shipping-addresses", "{id}", "default" ] }, "description": "设为默认\n\nScope: addresses:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/set-default-shipping-address" } } ] }, { "name": "卡密", "item": [ { "name": "POST /v1/cards/{id}/secure-session", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/secure-session", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "secure-session" ] }, "description": "换取一次性卡密查看票据\n\nScope: cards:secure\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/create-card-secure-session" } }, { "name": "POST /v1/cards/{id}/cvv/unblock", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/cvv/unblock", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "cvv", "unblock" ] }, "description": "解除 CVV 锁定\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/unblock-card-cvv" } } ] }, { "name": "模拟器", "item": [ { "name": "GET /v1/sandbox/card-scenarios", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/sandbox/card-scenarios", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "card-scenarios" ] }, "description": "沙盒 · 可模拟的卡交易场景清单\n\nScope: cards:read\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/list-sandbox-card-scenarios" } }, { "name": "POST /v1/sandbox/cards/{id}/simulate", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/sandbox/cards/{id}/simulate", "host": [ "{{base_url}}" ], "path": [ "v1", "sandbox", "cards", "{id}", "simulate" ] }, "description": "沙盒 · 让上游推一笔卡交易过来\n\nScope: cards:write\n文档：https://docs.zinfra.vip/card-issuance/v1/api-reference/simulate-card-transaction\n\n⚠ 这个端点会动钱：按场景动 member.card 与 card.pool（与生产同一批凭证）", "body": { "mode": "raw", "raw": "{\n \"scenario\": \"auth_ok\",\n \"amount\": \"12.99\",\n \"merchant_name\": \"NETFLIX.COM\",\n \"mcc\": \"4899\"\n}" } } } ] } ] }, { "name": "稳定币账户（Stablecoin Account）", "item": [ { "name": "余额", "item": [ { "name": "GET /v1/balances", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/balances", "host": [ "{{base_url}}" ], "path": [ "v1", "balances" ] }, "description": "会员逐资产余额（八桶）\n\nScope: balances:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/get-balances" } } ] }, { "name": "交易流水", "item": [ { "name": "GET /v1/transactions", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/transactions", "host": [ "{{base_url}}" ], "path": [ "v1", "transactions" ] }, "description": "会员流水（游标分页）\n\nScope: balances:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-transactions" } } ] }, { "name": "充值", "item": [ { "name": "GET /v1/deposits", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/deposits", "host": [ "{{base_url}}" ], "path": [ "v1", "deposits" ] }, "description": "入金记录（我方账本视角）\n\nScope: deposits:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-deposits" } }, { "name": "POST /v1/deposits", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/deposits", "host": [ "{{base_url}}" ], "path": [ "v1", "deposits" ] }, "description": "上报会员入金\n\nScope: deposits:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/report-deposit\n\n⚠ 这个端点会动钱：增会员 available，同额增 merchant.custody（我方替你记的负债）", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"amount\": \"1500.000000\",\n \"reference\": \"0xa3f1c2e9-0\",\n \"network\": \"BSC\",\n \"txid\": \"0xa3f1c2b7d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f\",\n \"from_address\": \"0x9C3f1B7a5E2d4C6b8A0f2E4d6C8b0A2f4E6d8C0b\",\n \"to_address\": \"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed\"\n}" } } }, { "name": "GET /v1/deposits/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/deposits/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "deposits", "{id}" ] }, "description": "单笔入金详情（含链上溯源）\n\nScope: deposits:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/get-deposit" } } ] }, { "name": "提现", "item": [ { "name": "GET /v1/withdrawals", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/withdrawals", "host": [ "{{base_url}}" ], "path": [ "v1", "withdrawals" ] }, "description": "提现列表（游标分页 + 四个筛选）\n\nScope: withdrawals:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-withdrawals" } }, { "name": "POST /v1/withdrawals", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/withdrawals", "host": [ "{{base_url}}" ], "path": [ "v1", "withdrawals" ] }, "description": "提现扣账（available → withdrawing）\n\nScope: withdrawals:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/create-withdrawal\n\n⚠ 这个端点会动钱：会员 available 减少，同额进 withdrawing（merchant.custody 不动）", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"amount\": \"200.000000\",\n \"to_address\": \"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed\"\n}" } } }, { "name": "GET /v1/withdrawals/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/withdrawals/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "withdrawals", "{id}" ] }, "description": "提现详情\n\nScope: withdrawals:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/get-withdrawal" } }, { "name": "POST /v1/withdrawals/{id}/confirm", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/withdrawals/{id}/confirm", "host": [ "{{base_url}}" ], "path": [ "v1", "withdrawals", "{id}", "confirm" ] }, "description": "商户完成链上出款后确认\n\nScope: withdrawals:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/confirm-withdrawal\n\n⚠ 这个端点会动钱：会员 withdrawing 清零，merchant.custody 同额减少" } }, { "name": "POST /v1/withdrawals/{id}/fail", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" } ], "url": { "raw": "{{base_url}}/v1/withdrawals/{id}/fail", "host": [ "{{base_url}}" ], "path": [ "v1", "withdrawals", "{id}", "fail" ] }, "description": "上链失败，全额退回可用\n\nScope: withdrawals:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/fail-withdrawal\n\n⚠ 这个端点会动钱：会员 withdrawing 清零，同额退回 available" } } ] }, { "name": "提现地址簿", "item": [ { "name": "GET /v1/withdraw-addresses", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/withdraw-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "withdraw-addresses" ] }, "description": "会员提现地址簿（冷静期未过的标 usable=false）\n\nScope: withdrawals:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-withdraw-addresses" } }, { "name": "POST /v1/withdraw-addresses", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/withdraw-addresses", "host": [ "{{base_url}}" ], "path": [ "v1", "withdraw-addresses" ] }, "description": "新增提现地址（挂强认证 + 24 小时冷静期）\n\nScope: withdrawals:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/create-withdraw-address", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"network\": \"BSC\",\n \"address\": \"0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed\",\n \"label\": \"我的冷钱包\"\n}" } } }, { "name": "DELETE /v1/withdraw-addresses/{id}", "request": { "method": "DELETE", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/withdraw-addresses/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "withdraw-addresses", "{id}" ] }, "description": "删除提现地址（软删，不挂强认证）\n\nScope: withdrawals:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/delete-withdraw-address" } } ] }, { "name": "站内兑换", "item": [ { "name": "GET /v1/exchange/pairs", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/exchange/pairs", "host": [ "{{base_url}}" ], "path": [ "v1", "exchange", "pairs" ] }, "description": "币对（按方向配：A→B 与 B→A 是两条独立记录）\n\nScope: exchange:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-exchange-pairs" } }, { "name": "POST /v1/exchange/quotes", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/exchange/quotes", "host": [ "{{base_url}}" ], "path": [ "v1", "exchange", "quotes" ] }, "description": "兑换报价（默认只读；带 `lock` 才锁价）\n\nScope: exchange:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/quote-exchange", "body": { "mode": "raw", "raw": "{\n \"from_asset\": \"USDT\",\n \"to_asset\": \"USD\",\n \"from_amount\": \"500.000000\",\n \"lock\": true\n}" } } }, { "name": "GET /v1/exchange/orders", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/exchange/orders", "host": [ "{{base_url}}" ], "path": [ "v1", "exchange", "orders" ] }, "description": "兑换订单列表（游标分页）\n\nScope: exchange:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/list-exchange-orders" } }, { "name": "POST /v1/exchange/orders", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/exchange/orders", "host": [ "{{base_url}}" ], "path": [ "v1", "exchange", "orders" ] }, "description": "兑换成交（原子 · 不可逆 · 无中间态）\n\nScope: exchange:write\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/create-exchange-order\n\n⚠ 这个端点会动钱：扣该会员的 from 资产 + 增他的 to 资产（同一名下，原子）", "body": { "mode": "raw", "raw": "{\n \"quote_id\": \"exc_7a1e5c30-2b44-4c11-9f8e-31d0a7b62c45\"\n}" } } }, { "name": "GET /v1/exchange/orders/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/exchange/orders/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "exchange", "orders", "{id}" ] }, "description": "兑换单详情（按 id 查一笔）\n\nScope: exchange:read\n文档：https://docs.zinfra.vip/stablecoin-account/v1/api-reference/get-exchange-order" } } ] } ] }, { "name": "理财（Wealth）", "item": [ { "name": "产品", "item": [ { "name": "GET /v1/earn/products", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/earn/products", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "products" ] }, "description": "理财产品（按 grant_scope + 授权表过滤）\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/list-earn-products" } }, { "name": "GET /v1/earn/products/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/earn/products/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "products", "{id}" ] }, "description": "理财产品详情\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/get-earn-product" } } ] }, { "name": "持仓", "item": [ { "name": "GET /v1/earn/positions", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/earn/positions", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "positions" ] }, "description": "持仓与累计收益\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/list-earn-positions" } }, { "name": "GET /v1/earn/positions/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/earn/positions/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "positions", "{id}" ] }, "description": "活期持仓详情（含其中未起息）\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/get-earn-position" } } ] }, { "name": "订单", "item": [ { "name": "POST /v1/earn/subscription-quotes", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/earn/subscription-quotes", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "subscription-quotes" ] }, "description": "理财申购预估（起息日 · 到期日 · 预计利息）\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/quote-earn-subscription", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"ern_8c1d\",\n \"amount\": \"1000.00\"\n}" } } }, { "name": "POST /v1/earn/subscriptions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/earn/subscriptions", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "subscriptions" ] }, "description": "申购（活期余额包 / 定期一单一行）\n\nScope: earn:write\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/create-earn-subscription\n\n⚠ 这个端点会动钱：会员可用余额 → 理财账户（同一名下重分类，两条腿自平）", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"ern_7d2b48ae-19c3-4f60-8c55-0ab3e9f21744\",\n \"amount\": \"1000.000000\",\n \"rollover_mode\": \"principal_interest\"\n}" } } }, { "name": "POST /v1/earn/redemptions", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "x-idempotency-key", "value": "{{$guid}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/earn/redemptions", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "redemptions" ] }, "description": "活期赎回（LIFO；定期不可提前赎回）\n\nScope: earn:write\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/create-earn-redemption\n\n⚠ 这个端点会动钱：理财账户 → 会员可用余额（本金 + 已计利息）", "body": { "mode": "raw", "raw": "{\n \"product_id\": \"ern_3a91f0c2-5d17-4e88-b2a0-91c7d4e6b501\",\n \"amount\": \"500.000000\"\n}" } } }, { "name": "GET /v1/earn/orders/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/earn/orders/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "orders", "{id}" ] }, "description": "定期订单详情\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/get-earn-order" } }, { "name": "GET /v1/earn/orders", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/earn/orders", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "orders" ] }, "description": "定期订单列表（利率是下单那一刻的快照）\n\nScope: earn:read\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/list-earn-orders" } }, { "name": "PATCH /v1/earn/orders/{id}/rollover", "request": { "method": "PATCH", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/v1/earn/orders/{id}/rollover", "host": [ "{{base_url}}" ], "path": [ "v1", "earn", "orders", "{id}", "rollover" ] }, "description": "改到期处理方式（枚举 principal_interest，不是 both）\n\nScope: earn:write\n文档：https://docs.zinfra.vip/wealth/v1/api-reference/set-earn-rollover", "body": { "mode": "raw", "raw": "{\n \"mode\": \"principal_interest\"\n}" } } } ] } ] } ] }