异步通知
卡的异步通知必须遵循 如何处理异步通知标准?,并且订阅了正确的通知类型以及URL。否则将可能无法通知到商户。
# 卡操作通知
当商户对卡有进行操作时,系统将推送 异步通知 (opens new window)。
# 通知参数
| 参数名 | 备注 |
|---|---|
| partner_order_id | 商户唯一交易id。 |
| card_id | 卡ID。开卡接口成功时返回的值。 |
| card_status | Pending: 创建接口请求成功;Processing:正在处理中;Active:卡开通成功时;Suspend:卡冻结;Failure:开卡失败;Closed:注销卡。 |
| fail_reason | 开卡结果。 |
| merchant_fee | 开卡产生的费用。 |
| -total_fee_amount | 开卡时额外的费用汇总。 |
| -fee_currency | 开卡时费用对应的币种。 |
| -fee_detail | 开卡时费用明细。 |
| --fee_detail | 费用明细金额。 |
| --fee_detail | 费用明细类型。RateFee:百分百费用;FixFee:固定费用;MinFee:最低收费;MaxFee:最大收费;CrossBoardFee:跨境费。 |
# 资金变动通知
当卡的资金有增加或减少时,系统将推送 资金变动通知 (opens new window)。
# 通知参数
| 参数名 | 备注 |
|---|---|
| partner_order_id | 商户唯一交易id。 |
| card_id | 开卡成功时返回的。 |
| transaction_id | 交易号。 |
| operate_type | card_id:卡的金额增加;card_out:卡的金额减少。 |
| status | Success:交易成功;Failure:交易失败。 |
| fail_reason | 失败原因。 |
| merchant_fee | 交易产生的费用。 |
| -total_fee_amount | 交易时额外的费用汇总。 |
| -fee_currency | 交易时费用对应的币种。 |
| -fee_detail | 交易时费用明细。 |
| --fee_detail | 费用明细金额。 |
| --fee_detail | 费用明细类型。RateFee:百分百费用;FixFee:固定费用;MinFee:最低收费;MaxFee:最大收费;CrossBoardFee:跨境费。 |
# 交易通知
当卡发生交易时,系统将推送 交易通知 (opens new window)。
# 通知参数
| 参数名 | 备注 |
|---|---|
| card_id | 开卡成功时返回的。 |
| transaction_id | 交易号。 |
| transaction_time | 交易时间。 |
| create_time | 订单创建时间。 |
| transaction_currency | 订单交易金额。 |
| transaction_amount | 订单交易金额。 |
| billing_currency | 交易账单币种。 |
| billing_amount | 交易账单金额。 |
| auth_code | 授权码授权时有发卡行产生,一般不超过6位字母数字组合。 |
| transaction_type | AuthorizationQuery:授权查询; Authorization:交易授权;Reversal:授权撤销;AuthorizationRefund:退款授权;AuthorizationRefundReversal:退款授权撤销。 |
| transaction_status | Success:交易成功;Failure:交易失败。 |
| cross_board_type | 0:本土交易;1:跨境交易。 |
| fail_reason | 交易结果。 |
| merchant_name | 卖家商户名称。 |
| mcc | Merchant category code商户行业编码,通常4位,如:4829。 |
| merchant_fee | 交易产生的费用。 |
| -total_fee_amount | 交易时额外的费用汇总。 |
| -fee_currency | 交易时费用对应的币种。 |
| -fee_detail | 交易时费用明细。 |
| --fee_detail | 费用明细金额。 |
| --fee_detail | 费用明细类型。RateFee:百分百费用;FixFee:固定费用;MinFee:最低收费;MaxFee:最大收费;CrossBoardFee:跨境费。 |