Z Zise Developers
/
简体中文
Account Center

Account Center

The platform layer shared by all products: tokens and signing, merchant accounts and funding, member registration, KYC, webhooks, sandbox, statements and reports.

Guides

Account Center OverviewAccount Center is the foundation for the other five products: tokens, merchant accounts, members, and webhooks all live here.QuickstartFrom receiving your API Key to your first real call in five minutes.Authentication and SigningOne Key contains two values—one obtains tokens, the other verifies signatures. PATH must be included in the signing string.API Keys and RotationEach Key contains two values, rotation includes an overlap window, and production requires an IP allowlist. Each has an important integration pitfall.Step-Up AuthenticationHigh-risk member actions need a step-up authentication ticket—who issues it and how to use it.IdempotencyKnow when to reuse an idempotency key and when to generate a new one; the rules serve different purposes.PaginationCursor pagination: next_cursor means another page exists; no next_cursor means the end.Rate LimitsRate limits are bucketed by merchant and endpoint; 429 includes Retry-After.Error ContractBranch on code rather than HTTP status; several counterintuitive cases all return 400.Time and TimezonesExisting time fields remain compatible, with new UTC Unix millisecond timestamps. Clients choose the display timezone.Versioning and CompatibilityWhat we promise to preserve or extend, and how new enums are announced in advance.Calling on Behalf of a MemberActing for a member: when x-on-behalf-of is required and what happens if it is wrong.Member Creation and LifecycleMembers are your users. We provide an identity and a ledger; pricing, limits, and risk controls are yours to manage.Member Creation and the Complete KYC FlowOne diagram covering member creation through KYC approval—who does what and when, plus three common wrong turns.KYC Overview and LevelsVerification levels determine which services a member can use. We make the decision; merchants may submit and update information through their server or use hosted pages.L1 KYC: Hosted Page and Required InformationObtain a link for the end user to fill in fifteen fields and upload ID photos on our page—the data never passes through your system.L2 Advanced Verification OpenAPI Integration for Downstream MerchantsMerchants upload files and submit L2 parameters directly, then query reviews and supplementary requests—all without a hosted page.Quick KYCExclusively bind a platform-pool profile to a member solely to create a cardholder with the issuer. This is not identity verification and cannot enable remittance.KYC Supplementary DocumentsQuery supplementary document templates, upload proof, and submit JSON. Both L1 and L2 support an API-only flow.WebhookEvents carry only IDs and states; query details separately. Signature verification, deduplication, and redelivery.Webhook Configuration and TroubleshootingConfigure endpoints, verify signatures, redeliver, and troubleshoot. Follow this sequence when events do not arrive.Merchant Accounts and Prepaid FundsPrepaid funds, credit, and low-water thresholds—three numbers determine when your services stop.Statements and Custody ReconciliationDaily statements report business activity; custody reconciliation checks whether the balances we record for you agree with yours.Sandboxzinfra.dev is an independent test environment with its own balances, members, and orders.Go-live ChecklistCheck credentials, Webhooks, limits, reconciliation, and alerts before launching.

Webhook

Member StatusEmitted when a member is successfully registered or their merchant-level suspension status changes.KYC DecisionsEmitted when identity verification reaches a new decision: approved, rejected or additional information required.

API Reference · 47 endpoints

Tokens Token

POST /v1/connect/token Obtain an access token

Merchant Account Merchant

GET /v1/merchant Merchant profile, authorized products, and effective limits GET /v1/merchant/balances Merchant funding accounts (available / frozen / payable / custody declaration) GET /v1/merchant/lines Business lines enabled for this merchant (including automatic low-balance suspension) GET /v1/merchant/pending Orders queued for insufficient prepayment (counts / by asset / oldest order) GET /v1/merchant/statements Business debit records (final prepayment debit per order) GET /v1/merchant/custody Custody reconciliation (balanced=false means a balance lacks your custody declaration) GET /v1/merchant/deposit-addresses Prepaid deposit address list POST /v1/merchant/deposit-addresses Request a prepaid deposit address (reused by asset × network) GET /v1/merchant/payout-addresses Your withdrawal address book (read-only; no POST) GET /v1/merchant/payouts Your payout requests (read-only; no initiation endpoint) GET /v1/merchant/topups Prepaid top-up records (on-chain receipts and offline settlement) POST /v1/merchant/topups Declare a prepaid top-up (primarily for offline settlement)

Members Members

GET /v1/members Member list (cursor pagination) POST /v1/members Create a member GET /v1/members/{id} Member details (KYC level and restriction status) PATCH /v1/members/{id} Update merchant-side attributes (nickname and language) POST /v1/members/{id}/suspend Suspend a member at merchant level (does not affect that person under other merchants) POST /v1/members/{id}/email-sessions Change the account email: obtain a hosted-screen link POST /v1/members/{id}/sessions/revoke Force a member to sign out (not a ban; they may sign in again immediately) GET /v1/members/{id}/limits Member limit usage (read-only; maximums are not returned)

Identity Verification KYC

GET /v1/kyc KYC result (level and minimal fields; no images or profile) PATCH /v1/kyc Update a member's KYC profile directly (partial update) GET /v1/kyc/quick The member's bound quick KYC profiles (no document numbers or images) POST /v1/kyc/quick Exclusively bind a quick KYC profile to a member POST /v1/kyc/files Upload a member's KYC file to Zinfra private storage POST /v1/kyc/applications Submit member L1 KYC directly from your server POST /v1/kyc/profile-sessions Update an identity profile: obtain a hosted-screen link GET /v1/kyc/requirements Required KYC levels by business line POST /v1/kyc/sessions Start L1 KYC (returns a link to our hosted screen) GET /v1/kyc/l2/config Query L2 parameter options and member eligibility GET /v1/kyc/l2/applications Query the most recent L2 application and document-supplement status POST /v1/kyc/l2/applications Submit advanced L2 verification as merchant-provided JSON POST /v1/kyc/l2/sessions Obtain a hosted-screen link for advanced L2 verification GET /v1/kyc/supplements Query outstanding document-supplement requests and parameter templates POST /v1/kyc/supplements/{id} Submit L1 or L2 supplement answers as parameters

Webhook Webhooks

GET /v1/webhooks/deliveries Webhook delivery records (without payload) POST /v1/webhooks/deliveries/{id}/redeliver Redeliver (only dead / failed / no_subscriber)

Asset Catalog Assets

GET /v1/assets Allowed assets, precision, and machine-readable network codes for each chain

Report Exports Reports

GET /v1/reports List my export tasks POST /v1/reports Create a reconciliation report export task (asynchronous; produces xlsx) GET /v1/reports/{id} Get an export task's status (poll here) GET /v1/reports/{id}/content Download an export (the response body is xlsx, not JSON)

Sandbox Sandbox

POST /v1/sandbox/faucet Sandbox: fund your sandbox prepaid account Moves funds GET /v1/sandbox/upstream-behaviors Sandbox: current injected behavior for each business line POST /v1/sandbox/upstream-behavior Sandbox: inject an upstream response behavior POST /v1/sandbox/reset Sandbox: clear delivery records and API logs