{ "info": { "name": "Zise Open API", "description": "Generated from apidocs/openapi/*.yaml. Request signing is included in the collection-level pre-request script.\nFirst set environment variables: base_url / merchant_id / signing_key / token (obtained from the token endpoint) / member_id.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "// Zise Open API · Request signing (five-part string + HMAC-SHA256)", "// Set three environment variables: base_url / merchant_id / signing_key; use {{token}} for the token.", "const CryptoJS = require('crypto-js');", "const ts = Math.floor(Date.now() / 1000).toString(); // Seconds, not milliseconds.", "const nonce = require('uuid').v4(); // Generate a fresh value for every request.", "const raw = pm.request.body && pm.request.body.raw ? pm.request.body.raw : '';", "// Hash the raw text. Do not JSON.parse and then stringify it again.", "const bodyHash = CryptoJS.SHA256(raw).toString(CryptoJS.enc.Hex);", "const url = pm.request.url;", "// PATH must include the query string to prevent replaying the same body against a different endpoint.", "const path = '/' + url.getPath().replace(/^//, '') + (url.getQueryString() ? '?' + url.getQueryString() : '');", "const base = [pm.request.method.toUpperCase(), path, ts, nonce, bodyHash].join('\\n');", "// The signature is Base64; the body hash above is Hex. These encodings must not be confused.", "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": "Tokens", "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": "Obtain an access token\n\nScope: —\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/connect-token" } } ] }, { "name": "Merchant Account", "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": "Merchant profile, authorized products, and effective limits\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Merchant funding accounts (available / frozen / payable / custody declaration)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Business lines enabled for this merchant (including automatic low-balance suspension)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Orders queued for insufficient prepayment (counts / by asset / oldest order)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Business debit records (final prepayment debit per order)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Custody reconciliation (balanced=false means a balance lacks your custody declaration)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Prepaid deposit address list\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Request a prepaid deposit address (reused by asset × network)\n\nScope: merchant:write\nDocumentation: https://docs.zinfra.dev/en/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": "Your withdrawal address book (read-only; no POST)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Your payout requests (read-only; no initiation endpoint)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Prepaid top-up records (on-chain receipts and offline settlement)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Declare a prepaid top-up (primarily for offline settlement)\n\nScope: merchant:write\nDocumentation: https://docs.zinfra.dev/en/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": "Members", "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": "Member list (cursor pagination)\n\nScope: members:read\nDocumentation: https://docs.zinfra.dev/en/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": "Create a member\n\nScope: members:write\nDocumentation: https://docs.zinfra.dev/en/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": "Member details (KYC level and restriction status)\n\nScope: members:read\nDocumentation: https://docs.zinfra.dev/en/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": "Update merchant-side attributes (nickname and language)\n\nScope: members:write\nDocumentation: https://docs.zinfra.dev/en/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": "Suspend a member at merchant level (does not affect that person under other merchants)\n\nScope: members:write\nDocumentation: https://docs.zinfra.dev/en/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": "Change the account email: obtain a hosted-screen link\n\nScope: members:write\nDocumentation: https://docs.zinfra.dev/en/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": "Force a member to sign out (not a ban; they may sign in again immediately)\n\nScope: members:write\nDocumentation: https://docs.zinfra.dev/en/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": "Member limit usage (read-only; maximums are not returned)\n\nScope: members:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/get-member-limits" } } ] }, { "name": "Identity Verification", "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 result (level and minimal fields; no images or profile)\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/get-kyc" } }, { "name": "PATCH /v1/kyc", "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/kyc", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc" ] }, "description": "Update a member's KYC profile directly (partial update)\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/update-kyc-profile", "body": { "mode": "raw", "raw": "{\n \"profile\": {\n \"first_name\": \"Alex\",\n \"occupation\": \"designer\",\n \"address\": \"25 Main Street\",\n \"phone_zone_number\": \"1\",\n \"phone\": \"2025550123\"\n }\n}" } } }, { "name": "GET /v1/kyc/quick", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/quick", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "quick" ] }, "description": "The member's bound quick KYC profiles (no document numbers or images)\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/get-quick-kyc" } }, { "name": "POST /v1/kyc/quick", "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/quick", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "quick" ] }, "description": "Exclusively bind a quick KYC profile to a member\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/bind-quick-kyc", "body": { "mode": "raw", "raw": "{\n \"card_product_id\": \"cpd_visa_virtual_usd\",\n \"email\": \"member+quick@example.com\"\n}" } } }, { "name": "POST /v1/kyc/files", "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/files", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "files" ] }, "description": "Upload a member's KYC file to Zinfra private storage\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/upload-kyc-file" } }, { "name": "POST /v1/kyc/applications", "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/kyc/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "applications" ] }, "description": "Submit member L1 KYC directly from your server\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/create-product-kyc-application", "body": { "mode": "raw", "raw": "{\n \"profile\": {\n \"first_name\": \"Jane\",\n \"last_name\": \"Doe\",\n \"nationality\": \"US\"\n }\n}" } } }, { "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": "Update an identity profile: obtain a hosted-screen link\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/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": "Required KYC levels by business line\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/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": "Start L1 KYC (returns a link to our hosted screen)\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/create-kyc-session", "body": { "mode": "raw", "raw": "{}" } } }, { "name": "GET /v1/kyc/l2/config", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/l2/config", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "l2", "config" ] }, "description": "Query L2 parameter options and member eligibility\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/get-kyc-l2-config" } }, { "name": "GET /v1/kyc/l2/applications", "request": { "method": "GET", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/kyc/l2/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "l2", "applications" ] }, "description": "Query the most recent L2 application and document-supplement status\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/get-latest-kyc-l2-application" } }, { "name": "POST /v1/kyc/l2/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/kyc/l2/applications", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "l2", "applications" ] }, "description": "Submit advanced L2 verification as merchant-provided JSON\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/submit-kyc-l2-application", "body": { "mode": "raw", "raw": "{\n \"profile\": \"…\",\n \"tos_acceptance\": \"…\"\n}" } } }, { "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": "Obtain a hosted-screen link for advanced L2 verification\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/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": "Query outstanding document-supplement requests and parameter templates\n\nScope: kyc:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/list-kyc-supplements" } }, { "name": "POST /v1/kyc/supplements/{id}", "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/supplements/{id}", "host": [ "{{base_url}}" ], "path": [ "v1", "kyc", "supplements", "{id}" ] }, "description": "Submit L1 or L2 supplement answers as parameters\n\nScope: kyc:write\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/submit-kyc-supplement", "body": { "mode": "raw", "raw": "{\n \"answers\": []\n}" } } } ] }, { "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 delivery records (without payload)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Redeliver (only dead / failed / no_subscriber)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/redeliver-webhook" } } ] }, { "name": "Asset Catalog", "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": "Allowed assets, precision, and machine-readable network codes for each chain\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/list-assets" } } ] }, { "name": "Report Exports", "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": "List my export tasks\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Create a reconciliation report export task (asynchronous; produces xlsx)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Get an export task's status (poll here)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Download an export (the response body is xlsx, not JSON)\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/download-report-export" } } ] }, { "name": "Sandbox", "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": "Sandbox: fund your sandbox prepaid account\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/sandbox-faucet\n\n⚠ This endpoint moves funds: Increases merchant prepaid available balance; the counterparty is 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": "Sandbox: current injected behavior for each business line\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Sandbox: inject an upstream response behavior\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Sandbox: clear delivery records and API logs\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/account-center/v1/api-reference/reset-sandbox" } } ] } ] }, { "name": "Global Account", "item": [ { "name": "Corridors and Rates", "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": "Available corridors, filtered by merchant authorization\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Rate board: no order or payee required\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Available settlement dates: an advance indication of arrival date\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Bank directory search: BIC / bank name → name + address\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/search-remit-swift" } } ] }, { "name": "Payees", "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": "Required fields for a corridor: validate the corridor before returning the form\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Payee list, including the name_mismatch risk flag\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Create or link a payee: local creation does not call the upstream\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/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": "Single payee, including upstream_status\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Update a payee nickname / favorite flag: only these two fields are editable\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/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": "Remove the association, not the payee entity\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/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": "Submit the payee for upstream onboarding early: moves no funds\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/verify-payee" } } ] }, { "name": "Quotes", "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": "Ordering prerequisites for both remittance lines: purpose codes / slippage / minimum amount / limits\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Remittance estimate: no order or fund hold; read applied_rate\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Remittance Orders", "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": "Remittance order details\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Personal remittance account agreement: six languages; users must read it before submission\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Check personal-line account-opening progress\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Submit a personal remittance (POBO) account application\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/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": "Remittance order list\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/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": "Create an order: payment retries reuse the same idempotency key\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/create-remittance\n\n⚠ This endpoint moves funds: Hold the member’s available asset balance by locked_amount, including slippage reserve, and simultaneously hold your prepaid funds", "body": { "mode": "raw", "raw": "{\n \"payee_id\": \"pye_1042\",\n \"payout_amount\": \"380.00\",\n \"slippage_bps\": 100,\n \"funding_source\": \"member\",\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": "Cancel: only needs_reconfirm is cancellable\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/cancel-remittance\n\n⚠ This endpoint moves funds: Release the member’s locked funds, including additional holds from every earlier round, back to available balance and simultaneously release your prepaid hold", "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": "Accept a price increase and hold the difference: 4-hour window\n\nScope: remittances:write\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/reconfirm-remittance\n\n⚠ This endpoint moves funds: Hold the additional extra_locked amount in locked and simultaneously increase your prepaid hold", "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": "What this order requires from the user: reconfirmation / documents / nothing\n\nScope: remittances:read\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/get-remittance-pending-action" } } ] }, { "name": "Merchant Conversions", "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": "Internal prepaid-asset conversion: available directions and current reference prices\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Executed internal conversions\n\nScope: merchant:read\nDocumentation: https://docs.zinfra.dev/en/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": "Internal prepaid-asset conversion (atomic, irreversible, no intermediate state)\n\nScope: merchant:write\nDocumentation: https://docs.zinfra.dev/en/global-account/v1/api-reference/create-merchant-conversion\n\n⚠ This endpoint moves funds: Your prepayment: debit the from asset / credit the to asset, under the same owner and balanced separately per asset.", "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": "QR Payments", "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": "QR payment order details\n\nScope: qrpay:read\nDocumentation: https://docs.zinfra.dev/en/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": "Read-only QR payment configuration: payment assets / balances / fees / limits\n\nScope: qrpay:read\nDocumentation: https://docs.zinfra.dev/en/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": "Decode a payment QR code: read-only, no order or fund hold\n\nScope: qrpay:write\nDocumentation: https://docs.zinfra.dev/en/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": "Quote for checkout confirmation: creates an upstream pending-payment order without holding funds\n\nScope: qrpay:write\nDocumentation: https://docs.zinfra.dev/en/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": "Pay by QR: hold funds before release; processing means outcome unknown, await webhook\n\nScope: qrpay:write\nDocumentation: https://docs.zinfra.dev/en/global-acquiring/v1/api-reference/create-qrpay-payment\n\n⚠ This endpoint moves funds: Hold the member’s available asset balance before notifying the upstream to release payment", "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": "QR payment order list\n\nScope: qrpay:read\nDocumentation: https://docs.zinfra.dev/en/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": "Available QR standards, synchronized from upstream rather than static constants\n\nScope: qrpay:read\nDocumentation: https://docs.zinfra.dev/en/global-acquiring/v1/api-reference/list-qrpay-schemes" } } ] } ] }, { "name": "Card Issuance", "item": [ { "name": "Card Products", "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": "Available card products (filtered by the merchant's authorized BINs)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Card issuance invoice: pricing and eligibility for this product and member\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/quote-card-product" } } ] }, { "name": "Card Applications", "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": "Submit a card application (virtual or physical, selected by form_factor)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/create-card-application\n\n⚠ This endpoint moves funds: Debits the member's available balance by default; funding_source=merchant debits only the merchant's main prepaid account.", "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": "Application status\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/get-card-application" } }, { "name": "GET /v1/cards/applications/{id}/recovery", "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}/recovery", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "recovery" ] }, "description": "Query a failed application's reason, refund, and separate KYC review progress\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/get-card-kyc-recovery" } }, { "name": "POST /v1/cards/applications/{id}/recovery", "request": { "method": "POST", "header": [ { "key": "authorization", "value": "Bearer {{token}}" }, { "key": "x-on-behalf-of", "value": "{{member_id}}" } ], "url": { "raw": "{{base_url}}/v1/cards/applications/{id}/recovery", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "applications", "{id}", "recovery" ] }, "description": "Submit corrected KYC directly, independently of the old application and refund\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/submit-card-kyc-recovery" } }, { "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": "Cancellation preview (eligibility and refund amount)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Cancel an application (the only self-service way to stop further loss)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/cancel-card-application\n\n⚠ This endpoint moves funds: Returns issuance and shipping fees to the member's available balance according to the current stage.", "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": "Document supplements: obtain a hosted-screen link for the end user\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Physical card shipping (one of four independent status axes)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/get-card-shipment" } } ] }, { "name": "Cards", "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": "Card list (first four and last four digits; never full card numbers)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Card details (first four and last four digits; never the full card number)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Change a card nickname\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Card transactions (cursor pagination)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/list-card-transactions" } } ] }, { "name": "Card Funding", "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": "Estimate a card top-up (no upstream call)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Top up a card (two asynchronous stages; the webhook confirms credit)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/create-card-topup\n\n⚠ This endpoint moves funds: Debits the member's available source-asset balance and freezes merchant prepayment; card credit is confirmed by 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": "Transfer funds from a card to the wallet (not an on-chain withdrawal)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/create-card-withdrawal\n\n⚠ This endpoint moves funds: Card funds (`member.card` bucket) → member available balance; fees follow product configuration.", "body": { "mode": "raw", "raw": "{\n \"amount\": \"10.50\"\n}" } } } ] }, { "name": "Spending Controls", "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": "Freeze a card (transitional state: freezing)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Unfreeze a card (transitional state: unfreezing; separate endpoint from freezing)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Set user-defined limits (0 means unset; the product maximum applies)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Read the card's merchant / MCC list\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Replace the entire merchant / MCC list (either an allowlist or a blocklist)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Clear the card's list (restore unrestricted use)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Change the billing address (used for AVS checks by US online merchants)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Lifecycle", "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": "Replacement progress or replacement quote (mutually exclusive sections)\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Report a lost / stolen card (irreversible; physical cards only)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Card closure precheck\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Close a card (irreversible; we return the remaining balance)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Request a card replacement (no direct balance transfer between old and new cards)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/request-card-replacement", "body": { "mode": "raw", "raw": "{\n \"reason\": \"pan_leaked\",\n \"note\": \"用户报告卡号在钓鱼站被输入\"\n}" } } } ] }, { "name": "Physical Cards", "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": "Bind a physical card (three card details; no step-up authentication)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Activate a physical card (irreversible; call directly after your own user verification)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/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": "Change / reset a PIN (use the CVV branch if the old PIN is forgotten)\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/set-card-pin", "body": { "mode": "raw", "raw": "{\n \"cvv\": \"123\",\n \"new_pin\": \"4821\"\n}" } } } ] }, { "name": "Shipping Addresses", "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": "Shipping address book\n\nScope: addresses:read\nDocumentation: https://docs.zinfra.dev/en/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": "Add a shipping address\n\nScope: addresses:write\nDocumentation: https://docs.zinfra.dev/en/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": "Get an address\n\nScope: addresses:read\nDocumentation: https://docs.zinfra.dev/en/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": "Update an address\n\nScope: addresses:write\nDocumentation: https://docs.zinfra.dev/en/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": "Delete an address\n\nScope: addresses:write\nDocumentation: https://docs.zinfra.dev/en/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": "Set the default address\n\nScope: addresses:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/set-default-shipping-address" } } ] }, { "name": "Secure Card Details", "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}}" } ], "url": { "raw": "{{base_url}}/v1/cards/{id}/secure-session", "host": [ "{{base_url}}" ], "path": [ "v1", "cards", "{id}", "secure-session" ] }, "description": "Retrieve the card number, CVV, and expiry date in real time\n\nScope: cards:secure\nDocumentation: https://docs.zinfra.dev/en/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": "Unblock CVV\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/unblock-card-cvv" } } ] }, { "name": "Simulator", "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": "Sandbox: available simulated card transaction scenarios\n\nScope: cards:read\nDocumentation: https://docs.zinfra.dev/en/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": "Sandbox: simulate an incoming upstream card transaction\n\nScope: cards:write\nDocumentation: https://docs.zinfra.dev/en/card-issuance/v1/api-reference/simulate-card-transaction\n\n⚠ This endpoint moves funds: Moves member.card and card.pool according to the scenario, using the same journal types as production.", "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": "Balances", "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": "Member balances by asset (eight buckets)\n\nScope: balances:read\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/get-balances" } } ] }, { "name": "Transaction History", "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": "Member transactions (cursor pagination)\n\nScope: balances:read\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/list-transactions" } } ] }, { "name": "Deposits", "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": "Deposit records (from our ledger's perspective)\n\nScope: deposits:read\nDocumentation: https://docs.zinfra.dev/en/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": "Declare a member deposit\n\nScope: deposits:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/report-deposit\n\n⚠ This endpoint moves funds: Increases member available balance and merchant.custody by the same amount, recording the liability we track for you.", "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": "Deposit details (including on-chain provenance)\n\nScope: deposits:read\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/get-deposit" } } ] }, { "name": "Withdrawals", "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": "Withdrawal list (cursor pagination and four filters)\n\nScope: withdrawals:read\nDocumentation: https://docs.zinfra.dev/en/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": "Debit a withdrawal (available → withdrawing)\n\nScope: withdrawals:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/create-withdrawal\n\n⚠ This endpoint moves funds: Decreases member available balance and increases withdrawing by the same amount; merchant.custody is unchanged.", "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": "Withdrawal details\n\nScope: withdrawals:read\nDocumentation: https://docs.zinfra.dev/en/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": "Confirm after the merchant completes the on-chain payout\n\nScope: withdrawals:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/confirm-withdrawal\n\n⚠ This endpoint moves funds: Clears the member's corresponding withdrawing amount and reduces merchant.custody equally." } }, { "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": "On-chain payout failed: return the full amount to available balance\n\nScope: withdrawals:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/fail-withdrawal\n\n⚠ This endpoint moves funds: Clears the member's corresponding withdrawing amount and returns it to available balance." } } ] }, { "name": "Withdrawal Addresses", "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": "Member withdrawal address book (addresses still cooling have usable=false)\n\nScope: withdrawals:read\nDocumentation: https://docs.zinfra.dev/en/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": "Add a withdrawal address (step-up authentication and a 24-hour cooling period)\n\nScope: withdrawals:write\nDocumentation: https://docs.zinfra.dev/en/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": "Delete a withdrawal address (soft deletion; no step-up authentication)\n\nScope: withdrawals:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/delete-withdraw-address" } } ] }, { "name": "Internal Conversions", "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": "Asset pairs: direction-specific; A→B and B→A are independent records\n\nScope: exchange:read\nDocumentation: https://docs.zinfra.dev/en/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": "Exchange quote: read-only by default; supply `lock` to lock the price\n\nScope: exchange:write\nDocumentation: https://docs.zinfra.dev/en/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": "Exchange order list, cursor-paginated\n\nScope: exchange:read\nDocumentation: https://docs.zinfra.dev/en/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": "Execute exchange: atomic, irreversible, no intermediate state\n\nScope: exchange:write\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/create-exchange-order\n\n⚠ This endpoint moves funds: Debit the member’s from asset and credit their to asset atomically under the same member", "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": "Exchange order details by ID\n\nScope: exchange:read\nDocumentation: https://docs.zinfra.dev/en/stablecoin-account/v1/api-reference/get-exchange-order" } } ] } ] }, { "name": "Wealth", "item": [ { "name": "Product", "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": "Earn products, filtered by grant_scope and authorization records\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/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": "Earn product details\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/wealth/v1/api-reference/get-earn-product" } } ] }, { "name": "Positions", "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": "Positions and cumulative returns\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/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": "Flexible position details, including the portion not yet accruing\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/wealth/v1/api-reference/get-earn-position" } } ] }, { "name": "Orders", "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": "Earn subscription estimate: accrual start / maturity / estimated interest\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/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": "Subscribe: flexible balance pool / individual fixed-term order\n\nScope: earn:write\nDocumentation: https://docs.zinfra.dev/en/wealth/v1/api-reference/create-earn-subscription\n\n⚠ This endpoint moves funds: Member available balance → Earn account, reclassified under the same member with balanced ledger legs", "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": "Flexible redemption, LIFO; fixed-term products cannot be redeemed early\n\nScope: earn:write\nDocumentation: https://docs.zinfra.dev/en/wealth/v1/api-reference/create-earn-redemption\n\n⚠ This endpoint moves funds: Earn account → member available balance, principal plus accrued interest", "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": "Fixed-term order details\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/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": "Fixed-term order list, with rates snapshotted at subscription\n\nScope: earn:read\nDocumentation: https://docs.zinfra.dev/en/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": "Change maturity handling: enum principal_interest, not both\n\nScope: earn:write\nDocumentation: https://docs.zinfra.dev/en/wealth/v1/api-reference/set-earn-rollover", "body": { "mode": "raw", "raw": "{\n \"mode\": \"principal_interest\"\n}" } } } ] } ] } ] }