Bill-Webhook
接口描述：
当卡余额有变动时，平台会推送通知至指定后台地址。
接口地址：
后台配置通知地址
请求方式：
POST
请求头部：
Content-Type: application/json
请求参数
| 参数名称 | 必填 | 示例 | 参数说明 |
|---|---|---|---|
| cardNumber | 是 | 1234567812345678 | 卡号 |
| recordNo | 是 | 245346345345 | 流水号 |
| occurTime | 是 | 2024-09-03 17:40:06 | 交易发生时间 |
| transCurrency | 是 | CNY | 交易币种 |
| transCurrencyAmt | 是 | 38.48 | 交易币种金额 |
| localCurrency | 是 | USD | 卡币种 |
| localCurrencyAmt | 是 | 38.48 | 卡本币种交易金额 |
| respCode | 是 | 000000 | 交易响应码 |
| respCodeDesc | 是 | 交易成功 | 交易响应码描述 |
| merchantName | 否 | WEIXIN*Meituan | 交易商户信息 |
| merchantCategoryCode | 否 | 5999 | 商户类型 |
| approvalCode | 是 | VWAJ0R | 批准代码 |
| crossBoardType | 是 | 1 | 跨境类型：0-境内 1-境外 |
| transType | 是 | AUTH | 交易类型：AUTH-消费 REFUND-退款 FEE-手续费 TOP UP-增值 REVERSAL-冲正 |
| transStatus | 是 | APPROVED | 交易状态：APPROVED-批准 DECLINED-拒绝 |
| platformType | 是 | 消费 | 描述 |
| appKey | 是 | edy2378eh23gf29w2 | appKey |
| sign | 是 | a87694dbd3be64a356a42be95e123360 | 接口签名 |
请求示例
{
"localCurrencyAmt": "10",
"occurTime": "2024-09-03 17:40:06",
"platformType": "开卡预存",
"sign": "d1fd48a0268506f4a131442a27485385",
"localCurrency": "USD",
"transCurrency": "USD",
"recordNo": "2409031607063343947",
"crossBoardType": "1",
"transType": "TOP UP",
"respCodeDesc": "交易成功",
"appKey": "psqxrezci72955wqxlhar898vx2q8lts",
"respCode": "000000",
"transCurrencyAmt": "10",
"transStatus": "APPROVED"
}
响应示例
ok （body内容为字符串“ok“）
注意事项
- 若未按要求返回
ok，平台将视为推送失败，平台将采用指数退避策略进行重试，初次推送失败后每隔1分钟进行重复推送5次。 - 若依然未成功回应，将在10分钟后再进行新一轮推送，如此共10组（共计最多50次）。
- 请确保及时正确响应，避免消息丢失。