OpenAPI 总览

这里是开发者查找接口的入口。按业务分组浏览，或直接搜索接口名称、HTTP 方法、请求路径。

近期接口文档调整见 变更记录。

调用地址

沙箱环境 Base URL：https://sandbox-ucard-openapi.futurepay.cc

生产环境 Base URL：https://card-openapi.futurepayapp.com

接口索引和单接口页展示的是完整请求 PATH，例如 /openapi/v1/cards/recharge。

对应的完整请求 URL 为 https://sandbox-ucard-openapi.futurepay.cc/openapi/v1/cards/recharge。

快速查找

在浏览器内使用页面搜索查找接口路径，例如 /openapi/v1/cards/recharge；站点也开启了本地搜索。

接入顺序

1. 阅读 加签说明，确认请求签名和响应验签。
2. 阅读 公共响应，确认统一响应外层结构。
3. 阅读 商户 Webhook，配置异步通知地址并实现验签、事件分发和幂等。
4. 在下面的接口索引中按业务场景进入具体 endpoint。

接口索引

健康检查

接口	方法	路径
查询服务健康状态	GET	/openapi/v1/health

用户接口

接口	方法	路径
注册用户	POST	/openapi/v1/users/createUser
分页查询当前租户用户	GET	/openapi/v1/users/list
上传 KYC 图片	POST	/openapi/v1/users/uploadKycImage
提交用户 KYC	POST	/openapi/v1/users/kyc
查询用户 KYC 状态	GET	/openapi/v1/users/kyc/status

卡接口

接口	方法	路径
用户开卡	POST	/openapi/v1/cards/issueCard
查询可办卡类型	GET	/openapi/v1/cards/types
绑卡	POST	/openapi/v1/cards/bindCard
分页查询开卡订单	GET	/openapi/v1/cards/open-orders
查询开卡订单详情	GET	/openapi/v1/cards/open-orders/{cardOrderNo}
查询用户开卡状态	GET	/openapi/v1/cards/status
查询卡详情	GET	/openapi/v1/cards
查询用户卡列表	GET	/openapi/v1/cards/list
查询卡敏感信息	GET	/openapi/v1/cards/sensitive
查询卡余额	GET	/openapi/v1/cards/balance
查询卡交易记录	GET	/openapi/v1/cards/transactions
创建卡激活申请	POST	/openapi/v1/cards/activations
锁卡	POST	/openapi/v1/cards/lock
解锁	POST	/openapi/v1/cards/unlock
重新激活	POST	/openapi/v1/cards/reactivate
挂失	POST	/openapi/v1/cards/reportLost
修改 PIN	POST	/openapi/v1/cards/pin
卡充值	POST	/openapi/v1/cards/recharge

资金接口

接口	方法	路径
卡提现	POST	/openapi/v1/funds/cardWithdrawals