WebHook通知

请求方式：POST
Content-Type: text/plain
数据内容：payload
响应方式：http status=200接收成功;否则会延迟多次补发通知
payload数据为加密后的数据，请用GEP公钥解密，解密方法参考解密流程。

接口地址

商户提供通知地址，找技术支持申请配置

明文参数

交易手续费type = trade_fee

3ds通知 type = card_3ds_otp

交易结果通知 type = card_transaction_v2

卡操作结果通知 type = type_card_operate

cardInfo数据说明

明文示例

{
  "data": {
    "amount": 98,
    "cardId": "2403282025000018833",
    "createAt": "2024-03-28 20:39:41",
    "fee": 0,
    "opType": 4,
    "orderId": "2403282039000201236",
    "status": 2,
    "statusDesc": "成功",
    "userReqNo": "W2024032820394010034"
  },
  "type": "type_card_operate"
}

👉常见交易流程

1. 消费(拒绝) → 结束

2. 消费(批准)

   • 消费(已清算·有 settleAmount) [无清算差额] → 结束
   • 消费(已清算·有 settleAmount) [有清算差额] → 清算差额(已清算) → 结束

3. 退款(已清算) → 结束
   （退款一般发生在原交易清算之后，但大多数关联不到原交易单号）

4. 消费(批准) → 冲正(批准) → 结束
   （已冲正的交易，原消费交易的状态不会再变为已清算）

5. 消费(批准) → 冲正(批准) → 消费(已清算·有 settleAmount) → 冲正后请款(已清算) → 结束

6. 强制清算(已清算·有 settleAmount) → 结束
   （强制清算是没有授权的直接清算的交易）

获取webhook数据

获取返回信息需获取请求中的流数据

• JAVA示例：

  BufferedReader reader = new BufferedReader(new InputStreamReader(request.getInputStream()));
  StringBuilder builder = new StringBuilder();
  String line;
  while ((line = reader.readLine()) != null) {
    builder.append(line);
  }
  String payload = builder.toString();
  // TODO  解密payload

• PHP示例：

  $payload = file_get_contents('php://input');
  echo "webhook接收通知内容:".$payload;
  // TODO  解密$payload