接入指南
管理员创建客户并签发访问令牌后，用请求头 x-auth-token 调用虚拟卡接口。请求体与官方发卡接口一致，不再传 app_id。平台钱包与上游发卡账户分开记账，一张卡只属于签发它的客户。
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
code |
int | 0 成功，-1 失败，-2 处理中或结果未知 |
success |
boolean | 是否成功 |
message |
string | 结果说明。失败时为错误原因 |
data |
object | 业务数据 |
data.server_time |
string | 服务器时间 |
正式环境
接口根地址为 https://uqpay.zytong.cn 。所有业务接口使用 POST，Content-Type 为 application/json。该域名下的后台和开放接口都写入正式库。
沙箱
沙箱根地址为 https://uqpay-sandbox.zytong.cn 。本机或局域网调试也使用沙箱库。后台和开放接口都会写入持卡人、卡片、订单和资金流水。demo.py 是客户接入示例：填入平台签发的 token，选择接口后打印返回值。
访问令牌
一个客户可以有多张凭证。每次调用在请求头 x-auth-token 放入对应 token，也可以使用 Authorization: Bearer token。token 只在签发时展示一次。请求体不要再传 app_id、timestamp 或 nonce。
资金规则
开卡扣减「开卡费 + 卡限额 + 卡限额 × 充值费率」。充值扣减「金额 + 金额 × 充值费率」。上游明确失败时退回。若返回 code=-2 或 fund_status 为 UNKNOWN，请用相同参数和原 out_order_no 再次调用原接口。不要更换单号。提现在上游订单成功后才记入钱包。注销卡片不会自动退回卡内余额，请先提现。
幂等
开卡、充值、提现、变更状态、创建持卡人都必须传 out_order_no。同一客户下单号唯一。code 为 -2 表示处理中或结果未知。