1. 其他
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
  • 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通知
  • 09. Fiat代收代付
    • 9.1 查询代收/代付银行列表
    • 9.2 创建代收订单
    • 9.3 创建代付订单
    • 9.4 提现USDT
    • 9.5 查询代收/代付订单
    • 9.6 查询汇率
    • 9.7 模拟代收/代付到账
  • 其他
    • [Sandbox] 修改WebHook-Url
      POST
    • JIT 授权交易
      POST
  1. 其他

JIT 授权交易

POST
callBackUrl
当持卡人发起信用卡交易时,卡组织会向 Tevau-Api 平台发送授权交易 Webhook 通知。Tevau-Api平台在完成内部校验(卡余额、企业余额、风控规则等)后,若该企业开启了 JIT(Just-In-Time)授权功能,将通过本接口向下游企业发起同步授权请求,由企业自行决定是否批准该笔交易。
下游企业收到授权请求后,必须在 2 秒内同步返回 HTTP 响应。
对接建议
1.
接口性能:确保回调接口响应时间 < 1.5 秒(预留网络传输时间),超过 2 秒将被视为超时拒绝
2.
决策逻辑:仅需返回 APPROVED 或 DECLINED,复杂的审批流程应在内部异步处理,同步接口只返回最终决策
3.
日志记录:建议下游企业对每次回调的请求和响应做完整日志记录,便于对账和问题排查

Request

Header Params

Body Params application/json

Example
{
    "atmTransactions": false,
    "cardFee": 3.50,
    "cardId": "CIDV013431541551",
    "channelFee": 3.91,
    "eventType": "AUTHORIZATION_REQUEST",
    "localTransactionAmount": 100.00,
    "localTransactionCurrency": "CNY",
    "merchantData": {
        "mccCode": "5815",
        "merchantCountry": "SE",
        "merchantId": "123456789123456",
        "merchantName": "Spotify"
    },
    "transAmount": 10.00,
    "transCurrency": "USD"
}

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 --request POST 'https://api-test.tevaupay.comcallBackUrl' \
--header 'x-nexus-api-key: c0d5e623fb6de1867f2e336975c934c6' \
--header 'appId: P3wmnamRzMsLjimu' \
--header 'timestamp: 20250901150426' \
--header 'nonce: 83D52F6DS38P3FTCH3M4B0CQ6AJZQDW4' \
--header 'sign: 8ca94291ed9cb1783df63a9eecb775f04bc2106993a9ef1c4c857dfd6b2eb832' \
--header 'versions: v1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "atmTransactions": false,
    "cardFee": 3.50,
    "cardId": "CIDV013431541551",
    "channelFee": 3.91,
    "eventType": "AUTHORIZATION_REQUEST",
    "localTransactionAmount": 100.00,
    "localTransactionCurrency": "CNY",
    "merchantData": {
        "mccCode": "5815",
        "merchantCountry": "SE",
        "merchantId": "123456789123456",
        "merchantName": "Spotify"
    },
    "transAmount": 10.00,
    "transCurrency": "USD"
}'

Responses

🟢200成功
application/json
Body

Example
{
  "decision": "DECLINED",
  "declineReason": "INSUFFICIENT_BUDGET"
}
Modified at 2026-03-18 08:28:12
Previous
[Sandbox] 修改WebHook-Url
Built with