异步通知
卡的异步通知必须遵循 如何处理异步通知标准?,并且订阅了正确的通知类型以及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 :跨境费。 |