{ "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 });", "pm.request.headers.upsert({ key: 'x-zise-merchant', value: pm.environment.get('merchant_id') });" ] } } ], "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://developers.ziseinfotest.com/api/listCardProducts" } }, { "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://developers.ziseinfotest.com/api/listCards" } }, { "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://developers.ziseinfotest.com/api/createCardApplication\n\n⚠ 这个端点会动钱：扣开卡费与邮费 + 锁定首充金额（会员可用余额）", "body": { "mode": "raw", "raw": "{\n \"form_factor\": \"virtual\",\n \"provider\": \"photonpay\",\n \"bin\": \"5240\",\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://developers.ziseinfotest.com/api/getCardApplication" } }, { "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://developers.ziseinfotest.com/api/createCardSecureSession" } }, { "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://developers.ziseinfotest.com/api/getCard" } }, { "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://developers.ziseinfotest.com/api/listCardTransactions" } }, { "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://developers.ziseinfotest.com/api/quoteCardTopup", "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://developers.ziseinfotest.com/api/createCardTopup\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://developers.ziseinfotest.com/api/createCardWithdrawal\n\n⚠ 这个端点会动钱：卡内资金（`member.card` 桶）→ 会员可用余额；手续费按产品配置", "body": { "mode": "raw", "raw": "{\n \"amount\": \"10.50\"\n}" } } }, { "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://developers.ziseinfotest.com/api/freezeCard" } }, { "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://developers.ziseinfotest.com/api/unfreezeCard" } }, { "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://developers.ziseinfotest.com/api/setCardLimits", "body": { "mode": "raw", "raw": "{\n \"single\": \"500.00\",\n \"daily\": \"2000.00\",\n \"monthly\": \"10000.00\"\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://developers.ziseinfotest.com/api/checkCardClose" } }, { "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://developers.ziseinfotest.com/api/closeCard", "body": { "mode": "raw", "raw": "{\n \"reason\": \"用户不再需要\"\n}" } } }, { "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://developers.ziseinfotest.com/api/bindPhysicalCard", "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://developers.ziseinfotest.com/api/activateCard", "body": { "mode": "raw", "raw": "{\n \"expiry\": \"08/29\",\n \"pin\": \"1234\"\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://developers.ziseinfotest.com/api/requestCardReplacement", "body": { "mode": "raw", "raw": "{\n \"reason\": \"pan_leaked\",\n \"note\": \"用户报告卡号在钓鱼站被输入\"\n}" } } }, { "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://developers.ziseinfotest.com/api/getCardShipment" } } ] }, { "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://developers.ziseinfotest.com/api/connectToken" } } ] }, { "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://developers.ziseinfotest.com/api/getMerchant" } }, { "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://developers.ziseinfotest.com/api/getMerchantBalances" } }, { "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://developers.ziseinfotest.com/api/listMerchantLines" } }, { "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://developers.ziseinfotest.com/api/listMerchantPending" } }, { "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://developers.ziseinfotest.com/api/listStatements" } }, { "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://developers.ziseinfotest.com/api/reconcileCustody" } }, { "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://developers.ziseinfotest.com/api/listMerchantDepositAddresses" } }, { "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:read\n文档：https://developers.ziseinfotest.com/api/createMerchantDepositAddress", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"network\": \"TRC20\"\n}" } } } ] }, { "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://developers.ziseinfotest.com/api/sandboxFaucet\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://developers.ziseinfotest.com/api/listSandboxBehaviors" } }, { "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://developers.ziseinfotest.com/api/setSandboxBehavior", "body": { "mode": "raw", "raw": "{\n \"upstream\": \"uqpay\",\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://developers.ziseinfotest.com/api/resetSandbox" } } ] }, { "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://developers.ziseinfotest.com/api/listAssets" } } ] }, { "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://developers.ziseinfotest.com/api/listMembers" } }, { "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://developers.ziseinfotest.com/api/createMember", "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://developers.ziseinfotest.com/api/getMember" } }, { "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://developers.ziseinfotest.com/api/updateMember", "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://developers.ziseinfotest.com/api/suspendMember", "body": { "mode": "raw", "raw": "{\n \"suspended\": false\n}" } } }, { "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://developers.ziseinfotest.com/api/revokeMemberSessions" } }, { "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://developers.ziseinfotest.com/api/getMemberLimits" } } ] }, { "name": "KYC", "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://developers.ziseinfotest.com/api/getKyc" } }, { "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://developers.ziseinfotest.com/api/getKycRequirements" } }, { "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://developers.ziseinfotest.com/api/listKycSupplements" } } ] }, { "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://developers.ziseinfotest.com/api/listWebhookDeliveries" } }, { "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://developers.ziseinfotest.com/api/redeliverWebhook" } } ] }, { "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://developers.ziseinfotest.com/api/listRemitCorridors" } }, { "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://developers.ziseinfotest.com/api/getPayeeFormSchema" } }, { "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://developers.ziseinfotest.com/api/listPayees" } }, { "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://developers.ziseinfotest.com/api/createPayee", "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": "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://developers.ziseinfotest.com/api/deletePayee" } }, { "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://developers.ziseinfotest.com/api/createRemitQuote", "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://developers.ziseinfotest.com/api/getRemittance" } }, { "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://developers.ziseinfotest.com/api/listRemittances" } }, { "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://developers.ziseinfotest.com/api/createRemittance\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://developers.ziseinfotest.com/api/cancelRemittance\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://developers.ziseinfotest.com/api/reconfirmRemittance\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://developers.ziseinfotest.com/api/getRemittancePendingAction" } } ] }, { "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://developers.ziseinfotest.com/api/getQrpayOrder" } }, { "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://developers.ziseinfotest.com/api/decodeQrCode", "body": { "mode": "raw", "raw": "{\n \"code_value\": \"00020101021229300012D156000000000510A93FO3230Q...\"\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://developers.ziseinfotest.com/api/createQrpayPayment\n\n⚠ 这个端点会动钱：锁定会员该资产的可用余额（先锁钱，再通知上游放行）", "body": { "mode": "raw", "raw": "{\n \"code_value\": \"00020101021229300012D156000000000510A93FO3230Q...\",\n \"currency\": \"THB\",\n \"amount\": \"250.00\",\n \"preferred_asset\": \"USDT\"\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://developers.ziseinfotest.com/api/listQrpayOrders" } }, { "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://developers.ziseinfotest.com/api/listQrpaySchemes" } } ] }, { "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://developers.ziseinfotest.com/api/listExchangePairs" } }, { "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": "兑换报价（只读，不建单、不锁钱）\n\nScope: exchange:write\n文档：https://developers.ziseinfotest.com/api/quoteExchange", "body": { "mode": "raw", "raw": "{\n \"from_asset\": \"USDT\",\n \"to_asset\": \"USD\",\n \"from_amount\": \"500.000000\"\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://developers.ziseinfotest.com/api/listExchangeOrders" } }, { "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://developers.ziseinfotest.com/api/createExchangeOrder\n\n⚠ 这个端点会动钱：扣该会员的 from 资产 + 增他的 to 资产（同一名下，原子）", "body": { "mode": "raw", "raw": "{\n \"from_asset\": \"USDT\",\n \"to_asset\": \"USD\",\n \"from_amount\": \"500.000000\"\n}" } } } ] }, { "name": "站内转账", "item": [ { "name": "GET /v1/transfers/recipient-types", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/v1/transfers/recipient-types", "host": [ "{{base_url}}" ], "path": [ "v1", "transfers", "recipient-types" ] }, "description": "收款人标识方式白名单（由服务端下发）\n\nScope: transfers:read\n文档：https://developers.ziseinfotest.com/api/listTransferRecipientTypes" } }, { "name": "POST /v1/transfers/resolve", "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/transfers/resolve", "host": [ "{{base_url}}" ], "path": [ "v1", "transfers", "resolve" ] }, "description": "解析收款人（返回脱敏昵称供二次确认）\n\nScope: transfers:read\n文档：https://developers.ziseinfotest.com/api/resolveTransferRecipient", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"recipient_type\": \"uid\",\n \"recipient\": \"10023481\"\n}" } } }, { "name": "GET /v1/transfers", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/transfers", "host": [ "{{base_url}}" ], "path": [ "v1", "transfers" ] }, "description": "转账列表（收发两侧都在内，游标分页）\n\nScope: transfers:read\n文档：https://developers.ziseinfotest.com/api/listTransfers" } }, { "name": "POST /v1/transfers", "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/transfers", "host": [ "{{base_url}}" ], "path": [ "v1", "transfers" ] }, "description": "发起站内转账（一步到账，没有待审态）\n\nScope: transfers:write\n文档：https://developers.ziseinfotest.com/api/createTransfer\n\n⚠ 这个端点会动钱：扣付款会员的可用余额 + 增收款会员的可用余额（一步到账）", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"recipient_type\": \"uid\",\n \"recipient\": \"10023481\",\n \"amount\": \"120.000000\",\n \"memo\": \"房租\"\n}" } } }, { "name": "GET /v1/transfers/{id}", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/transfers/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "transfers", "{id}" ] }, "description": "站内转账详情（原子、不可逆、无中间态）\n\nScope: transfers:read\n文档：https://developers.ziseinfotest.com/api/getTransfer" } } ] }, { "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://developers.ziseinfotest.com/api/listEarnProducts" } }, { "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://developers.ziseinfotest.com/api/listEarnPositions" } }, { "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://developers.ziseinfotest.com/api/getEarnProduct" } }, { "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://developers.ziseinfotest.com/api/createEarnSubscription\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://developers.ziseinfotest.com/api/createEarnRedemption\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", "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://developers.ziseinfotest.com/api/listEarnOrders" } }, { "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://developers.ziseinfotest.com/api/setEarnRollover", "body": { "mode": "raw", "raw": "{\n \"mode\": \"principal_interest\"\n}" } } } ] }, { "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://developers.ziseinfotest.com/api/getBalances" } } ] }, { "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://developers.ziseinfotest.com/api/listTransactions" } } ] }, { "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://developers.ziseinfotest.com/api/listDeposits" } }, { "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://developers.ziseinfotest.com/api/reportDeposit\n\n⚠ 这个端点会动钱：增会员 available，同额增 merchant.custody（我方替你记的负债）", "body": { "mode": "raw", "raw": "{\n \"asset\": \"USDT\",\n \"amount\": \"1500.000000\",\n \"reference\": \"0xa3f1c2...e9:0\"\n}" } } } ] }, { "name": "提现", "item": [ { "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://developers.ziseinfotest.com/api/createWithdrawal\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://developers.ziseinfotest.com/api/getWithdrawal" } }, { "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://developers.ziseinfotest.com/api/confirmWithdrawal\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://developers.ziseinfotest.com/api/failWithdrawal\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://developers.ziseinfotest.com/api/listWithdrawAddresses" } }, { "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://developers.ziseinfotest.com/api/createWithdrawAddress", "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://developers.ziseinfotest.com/api/deleteWithdrawAddress" } } ] } ] }