1. 03. 卡片
Tevau-Api文档
  • Get started
  • 签名说明
  • 交易说明
  • FAQ
  • 01. 客户
    • 1.1 创建客户
      POST
    • 1.2 查询客户
      POST
  • 02. KYC
    • 2.1 V1提交客户KYC信息
    • 2.2 获取活体认证URL
    • 2.3 查询活体认证结果
    • 2.4 查询客户KYC状态和信息
    • 2.5 [Sandbox] 模拟KYC审核
    • 2.6 创建文档文件
    • 2.7 上传文档文件
    • 2.8 V2提交客户KYC信息
  • 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
  • 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.6 查询汇率
    • 9.7 模拟代收/代付到账
  • 其他
    • [Sandbox] 修改WebHook-Url
    • JIT 授权交易
  • Schemas
    • RPageDataGetCardAccountDetailPageResp
    • PageDataGetCardAccountDetailPageResp
    • GetCardAccountDetailPageResp
  1. 03. 卡片

3.1 创建卡

POST
/openapi/card/submitCard
此接口可以在线申请虚拟卡或实体卡，UserCode每五秒限流。
如果是实体卡则需收货地址用于收货，如果是虚拟卡卡则需账单地址
在线申请实体卡不会返回cardId，需要平台发货后回调cardId给接入方。

Request

Header Params

Body Params application/json

Example
{
    "userCode": "CB14837342",
    "cardCode": 1004,
    "dialCode": 852,
    "phoneNumber": "12345678",
    "email": "123456@gmail.com",
    "billingAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456"
    },
    "postalAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "firstName": "Jack",
        "lastName": "Wang",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456",
        "province": "province",
        "recipientTitle": "recipientTitle"
    }
}

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/card/submitCard' \
--header 'x-nexus-api-key: 1' \
--header 'versions: v1' \
--header 'appId: P3wmnamRzMsLjimu' \
--header 'timestamp: {{$date.timestamp}}' \
--header 'nonce: {{$string.uuid}}' \
--header 'sign: 8ca94291ed9cb1783df63a9eecb775f04bc2106993a9ef1c4c857dfd6b2eb832' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userCode": "CB14837342",
    "cardCode": 1004,
    "dialCode": 852,
    "phoneNumber": "12345678",
    "email": "123456@gmail.com",
    "billingAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456"
    },
    "postalAddress": {
        "address": "Room 001 How Ming Street Kwun Tong Kowloon",
        "firstName": "Jack",
        "lastName": "Wang",
        "countryArea": "HK",
        "city": "HongKong",
        "postCode": "123456",
        "province": "province",
        "recipientTitle": "recipientTitle"
    }
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "cardId": "CIDP012954903239",
        "orderNo": "CA2505231726137808965"
    },
    "ok": true
}
🟠404异常说明
Modified at 2026-06-04 14:49:39
Previous
2.8 V2提交客户KYC信息
Next
3.2 查询客户的卡
Built with