EASYCARDS VCC API

让卡业务接入你的产品。
清晰、可靠、可验证。

从创建持卡人、提交开卡,到充值、共享卡提现、交易查询与 Webhook 对账。按真实业务顺序完成集成,也可在 API Reference 中查询全部 VCC 接口。

Sandbox 可用 OpenAPI 3.0 Bearer Token
create-card-application.sh
curl --request POST \
  --url https://sandbox.easycards.io/payment/vcc/card-applications \
  --header 'Authorization: Bearer $API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "request_id": "req_20260806_001",
    "customer_id": "cus_example",
    "product_code": "1103"
  }'

# 响应:异步请求已受理
{
  "code": "SUCCESS",
  "data": {
    "application_id": "app_example",
    "status": "PENDING"
  }
}
文档

按你的工作方式开始

先读完整流程、直接查接口,或下载契约导入现有工具。

P

商户后台操作手册

按当前 Portal 逻辑说明企业入户、资金账户、团队邀请、共享卡、储值卡、充值审批和系统设置。

进入 Portal 手册
H5

持卡人 H5 使用手册

面向受邀持卡人,说明账户激活、TOTP、个人 KYC、卡片、充值申请、交易和个人设置。

进入 H5 手册
01

VCC 对接手册

覆盖认证、产品、持卡人、KYC、开卡、敏感卡信息、充值、共享卡提现、交易和 Webhook。

按步骤接入
</>

API 参考

基于 OpenAPI 生成的 VCC 与配套账户接口参考,支持搜索、字段说明和 Sandbox 请求示例。

查看全部接口

核心业务流程

通过时序图查看 VCC 产品查询、持卡人、开卡、KYC、Webhook 与查询对账。

查看流程图
快速开始

先跑通,再扩展

建议先用 Sandbox 验证认证、权限与账户,再进入完整 VCC 流程。

1

获取 API Key

创建最小权限的 Payment API Key,并安全保存。

2

验证账户与权限

调用 GET /payment/account,确认认证、白名单和账户范围。

3

查询实时产品配置

调用 GET /payment/vcc/products 取得当前产品与费用。

4

按异步流程确认终态

保存资源 ID,通过 Webhook 与查询接口完成幂等处理和对账。