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