虚拟卡消费webhook

简要描述

卡交易webhook 配置及使用:

  • 请联系工作人员后台配置您的Webhook Endpoint Url, Url 必须是HTTPS
  • 当出现卡产生消费/退款/拒付等交易时,将推送对应交易消息到您的Webhook Endpoint Url
  • 收到Webhook 消息后,如果返回HTTP CODE 200, 表示您已成功接收到webhook消息
  • 通知频率为10分钟一次,一个小时后,1小时一次,总共24小时

返回参数说明

参数名

类型

说明

email

string

邮箱

transactionId

string

交易id, 同一笔交易id 唯一

cardId

string

虚拟卡id

cardNumber

string

卡号

cardSeqNo

string

卡序列号

desp

string

交易描述信息

reason

string

拒付原因

preAuthAmount

string

预授权金额(可能与最终交易金额不一样)

preAuthCurrency

string

预授权币种,USD

preAuthTime

string

预授权时间

transactionAmount

string

成交金额

transactionCurrency

string

成交币种,USD

transactionTime

string

成交时间

status

string

交易状态:
PENDING :交易授权PENDING
EXPIRED:授权过期
REVERSED:授权退回(例如绑卡预扣退回)
DECLINED:拒付
COMPLETE:交易完成
REFUND :交易退款
FEE: transaction fee
MONTHLY_FEE: monthly fee(Only for monthly fee cards)

gmtCreate

string

记录创建时间

gmtModified

string

记录更新时间

返回示例

PENDING 示例

{  
      "email":"[card@alchemytech.io](mailto:card@alchemytech.io)",  
      "transactionId":"t_xxxxxxxxxxxxx",  
      "cardId":"c_xxxxxxxxxxx",  
      "cardNumber":"556735XXXXXX0737",  
      "cardSeqNo":"CXXXXXXX",  
      "desp":"FACEBK UYFYREF3S2      fb.me/ads     IRL",  
      "reason":null,  
      "preAuthAmount": -1992,  
      "preAuthCurrency":"USD",  
      "preAuthTime":"2023-12-04 18:20:10",  
      "transactionAmount":null,  
      "transactionCurrency":null,  
      "transactionTime":null,  
      "status":"PENDING",  
      "gmtCreate":"2023-10-16 19:03:43",  
      "gmtModified":"2023-10-16 19:03:43"  
  }  
}

EXPIRED 示例

{  
      "email":"[card@alchemytech.io](mailto:card@alchemytech.io)",  
      "transactionId":"t_xxxxxxxxxxxxx",  
      "cardId":"c_xxxxxxxxxxx",  
      "cardNumber":"556735XXXXXX0737",  
      "cardSeqNo":"CXXXXXXX",  
      "desp":"FACEBK UYFYREF3S2      fb.me/ads     IRL",  
      "reason":null,  
      "preAuthAmount": -1992,  
      "preAuthCurrency":"USD",  
      "preAuthTime":"2023-12-04 18:20:10",  
      "transactionAmount":null,  
      "transactionCurrency":null,  
      "transactionTime":null,  
      "status":"EXPIRED",  
      "gmtCreate":"2023-10-16 19:03:43",  
      "gmtModified":"2023-10-16 19:03:43"  
}

REVERSED 示例

{  
      "email":"[card@alchemytech.io](mailto:card@alchemytech.io)",  
      "transactionId":"t_xxxxxxxxxxxxx",  
      "cardId":"c_xxxxxxxxxxx",  
      "cardNumber":"556735XXXXXX0737",  
      "cardSeqNo":"CXXXXXXX",  
      "desp":"FACEBK UYFYREF3S2      fb.me/ads     IRL",  
      "reason":null,  
      "preAuthAmount": -1992,  
      "preAuthCurrency":"USD",  
      "preAuthTime":"2023-12-04 18:20:10",  
      "transactionAmount":null,  
      "transactionCurrency":null,  
      "transactionTime":null,  
      "status":"REVERSED",  
      "gmtCreate":"2023-10-16 19:03:43",  
      "gmtModified":"2023-10-16 19:03:43"  
}

COMPLETE 示例

{  
      "email":"[card@alchemytech.io](mailto:card@alchemytech.io)",  
      "transactionId":"t_xxxxxxxxxxxxx",  
      "cardId":"c_xxxxxxxxxxx",  
      "cardNumber":"556735XXXXXX0737",  
      "cardSeqNo":"CXXXXXXX",  
      "desp":"FACEBK UYFYREF3S2      fb.me/ads     IRL",  
      "reason":"balance not enough",  
      "preAuthAmount": -1992,  
      "preAuthCurrency":"USD",  
      "preAuthTime":"2023-12-04 18:20:10",  
      "transactionAmount":-1992,  
      "transactionCurrency":"USD",  
      "transactionTime":166662674000,  
      "status":"COMPLETE",  
      "gmtCreate":"2023-10-16 19:03:43",  
      "gmtModified":"2023-10-16 19:03:43"  
}

REFUND 示例

{  
      "email":"[card@alchemytech.io](mailto:card@alchemytech.io)",  
      "transactionId":"t_xxxxxxxxxxxxx",  
      "cardId":"c_xxxxxxxxxxx",  
      "cardNumber":"556735XXXXXX0737",  
      "cardSeqNo":"CXXXXXXX",  
      "desp":"FACEBK UYFYREF3S2      fb.me/ads     IRL",  
      "reason":"balance not enough",  
      "preAuthAmount": null,  
      "preAuthCurrency":null,  
      "preAuthTime":null,  
      "transactionAmount": 1992,  
      "transactionCurrency":"USD",  
      "transactionTime": "2023-12-04 18:20:10",  
      "status":"REFUND",  
      "gmtCreate":"2023-10-16 19:03:43",  
      "gmtModified":"2023-10-16 19:03:43"  
}

备注

更多返回错误代码请看首页的错误代码描述


Did this page help you?