1. 02. KYC
Tevau-Api文档
  • Get started
  • 签名说明
  • 交易说明
  • FAQ
  • 全量异常编码
  • 交易拒绝原因
  • 01. 客户
    • 1.1 创建客户
      POST
    • 1.2 查询客户
      POST
  • 02. KYC
    • 2.1 V1提交客户KYC信息
      POST
    • 2.2 获取活体认证URL
      POST
    • 2.3 查询活体认证结果
      POST
    • 2.4 查询客户KYC状态和信息
      POST
    • 2.5 [Sandbox] 模拟KYC审核
      POST
    • 2.6 创建文档文件
      POST
    • 2.7 上传文档文件
      POST
    • 2.8 V2提交客户KYC信息
      POST
  • 03. 卡片
    • 3.1 创建卡
      POST
    • 3.2 查询客户的卡
      POST
    • 3.3 调整卡余额
      POST
    • 3.4 查询卡详情
      POST
    • 3.5 绑定实体卡
      POST
    • 3.6 注销卡
      POST
    • 3.7 冻结卡
      POST
    • 3.8 解冻卡
      POST
    • 3.9 激活实体卡
      POST
    • 3.10 查询卡PAN-HTML
      POST
    • 3.11 查PIN码
      POST
    • 3.12 查询卡限额
      POST
    • 3.13 调整卡费用
      POST
    • 3.14 查询卡费用
      POST
    • 3.15 卡交易3DS授权确认、取消
      POST
    • 3.16 更新卡手机号
      POST
    • 3.17 更新卡邮箱
      POST
    • 3.18 修改卡Pin
      POST
    • 3.19 查询卡片Token列表
      POST
    • 3.20 激活卡片Google/Apple Token
      POST
    • 3.21 卡片交易限额（废弃）
      POST
    • 3.22 查询卡账户流水
      POST
    • 3.23 查询卡操作处理结果
      POST
    • 3.24批量卡充值任务提交
      POST
    • 3.25批量卡充值任务状态查询
      POST
  • 04. 物流信息查询
    • 4.1 物流信息查询
  • 05. 预付款
    • 5.1 查询企业账户余额
    • 5.2 查询预付款账户交易列表
    • 5.3 查询企业账户余额（Fiat）
  • 06. 交易
    • 6.1 查询交易记录
    • 6.2 查询单笔交易详情
  • 07. 模拟交易
    • 7.1 模拟授权 (Authorisation)
    • 7.2 模拟结算 (Clearing)
    • 7.3 模拟退款 (Refund)
    • 7.4 模拟退单 (Reversal)
    • 7.5 模拟3DS (3DS)
    • 7.6 模拟卡片状态
  • 08. Webhook
    • 8.1 KYC审核通知
    • 8.2 卡片结果通知
    • 8.3 调整卡余额的通知
    • 8.4 授权3DS通知
    • 8.5 交易通知
    • 8.6 物流状态变化通知
    • 8.7 Token通知
    • 8.8 代收代付WebHook通知
    • 8.9 风控冻结卡片结果通知
    • 8.10 绑定Google、Apple失败通知
    • 8.11 资金池充值到账通知
  • 09. Fiat代收代付
    • 9.1 查询代收/代付银行列表
    • 9.2 创建代收订单
    • 9.3 创建代付订单
    • 9.4 提现USDT
    • 9.5 查询代收/代付订单
    • 9.7 模拟代收/代付到账
  • 其他
    • [Sandbox] 修改WebHook-Url
    • [Sandbox] 查询手续费配置
    • [Sandbox] 修改手续费配置
    • JIT 授权交易
  • Schemas
    • 请求体
    • 请求体
    • BatchRechargeSubmitReq
    • RPageDataGetCardAccountDetailPageResp
    • FeeItem
    • BatchRechargeSubmitResp
    • PageDataGetCardAccountDetailPageResp
    • FeeConfigTestResp
    • BatchRechargeQueryResp
    • GetCardAccountDetailPageResp
    • FeeItemDetail
    • 响应体
  1. 02. KYC

2.1 V1提交客户KYC信息

POST
/openapi/kyc/submitKycData
1.
主要用于提交客户KYC的基础信息；
2.
审核失败时，可重新提交；
3.
审核通过或失败时，在接口8.1中会回调审核结果，一般情况下会在1个工作日内，回调最终审核通知结果；
4.
也可自行通过接口2.4查询审核结果；
5.
测试环境有提供模拟KYC审核接口；
6.
虚拟卡和实体卡的客户KYC逻辑是一致的；
7.
提交间隔限制为10秒；
7.同一个userCode一天最多提交5次KYC，UTC时间0点重置；

Request

Header Params

Body Params application/json

Example
{
    "userCode": "CN54746255",
    "countryArea": "HK",
    "firstNameEn": "jack",
    "lastNameEn": "cheng",
    "birthday": "2001-09-27",
    "identityCardType": 1,
    "identityFrontPicUrl": "https://fastly.picsum.photos/id/1015/800/500.jpg?hmac=pSNYsY7XYU05VD89MUu0QDrVHgAu2yZaGSC4wzh7ld8",
    "identityBackPicUrl": "https://fastly.picsum.photos/id/1015/800/500.jpg?hmac=pSNYsY7XYU05VD89MUu0QDrVHgAu2yZaGSC4wzh7ld8",
    "identityCard": "009527",
    "identityCardValidityTime": "1982-07-31",
    "gender": 1
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-test.tevaupay.com/openapi/kyc/submitKycData' \
--header 'x-nexus-api-key: 9a50f67a8d76d343896c4c1c2330bde8' \
--header 'versions: v1' \
--header 'appId: P3wmnamRzMsLjimu' \
--header 'timestamp: {{$date.timestamp}}' \
--header 'nonce: {{$string.uuid}}' \
--header 'sign: 8ca94291ed9cb1783df63a9eecb775f04bc2106993a9ef1c4c857dfd6b2eb832' \
--header 'Content-Type: application/json' \
--data '{
    "userCode": "CN54746255",
    "countryArea": "HK",
    "firstNameEn": "jack",
    "lastNameEn": "cheng",
    "birthday": "2001-09-27",
    "identityCardType": 1,
    "identityFrontPicUrl": "https://fastly.picsum.photos/id/1015/800/500.jpg?hmac=pSNYsY7XYU05VD89MUu0QDrVHgAu2yZaGSC4wzh7ld8",
    "identityBackPicUrl": "https://fastly.picsum.photos/id/1015/800/500.jpg?hmac=pSNYsY7XYU05VD89MUu0QDrVHgAu2yZaGSC4wzh7ld8",
    "identityCard": "009527",
    "identityCardValidityTime": "1982-07-31",
    "gender": 1
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "code": 0,
    "msg": "SUCCESS",
    "data": null,
    "ok": true
}
🟠404异常描述
Modified at 2026-10-08 08:51:21
Previous
02. KYC
Next
2.2 获取活体认证URL
Built with