通知机制说明
通知重试策略
- 触发条件:当GEP未收到
OK
响应时(vcc交易的Webhook通知需HTTP Status=200) - 重试机制:
- 最大重试次数:10次
- 间隔频率(分钟):0×2m, 1×2m, 2×2m, 3×2m, 4×2m, 5×2m, 6×2m, 7×2m, 8×2m, 9×2m
建议商户接口响应时间控制在3秒以内,避免因超时导致重复通知
通知地址要求
URL规范:
- 禁止包含特殊字符(空格、HTML标签等)
- 不支持重定向(会导致无法接收
OK
响应)
接收方式:
// PHP $_POST['dataContent'] // Java request.getParameter("dataContent") // .NET Request.Form["dataContent"]
幂等性处理
- 相同参数的通知请求可能重复发送
- 商户系统需保证:
- 相同请求只处理一次
- 记录已处理的通知ID
通知地址
参考对应接口说明
通知参数
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
01. | 版本编号 | version | C | String(6) | 1.0.0 |
02. | 证书编号 | certificateId | M | Number | GEP提供给代理商的证书编号 |
03. | 代理商编号 | agentNo | M | Number | GEP提供给代理商的唯一编号 |
04. | 用户编号 | userno | C | Number | 在GEP系统开通的唯一商户编号 |
05. | 数据类型 | dataType | C | String(8) | JSON |
06. | 加密数据 | dataContent | M | String(2048) | 具体参数参考接口文档中的 加密数据dataContent 说明 解密方法参考 加解密说明 |
通知示例
{
"agentNo": "5182210819000222768",
"certificateId": "2103021706000005085",
"errorMsg": "受理成功",
"dataContent": "459413c733b3e11fbb5de0a0b56088b5240994e9c9f640647fea863155c67adc74040a6e740e7e13c75746659f0db2d4ed4faa4879996b11e934fb9a7a6982f1f66e2cfac2bcf2cf1bcd6d4c1c6dfc9871d20083bbe167dc9a5b11da36b15e6f8cc679a758a99ec11dd3c66239a23027fa993f9f99d46b2886f688e02941eea37f31034fabf651263667a9d2713f5f5488b01abb6058fca9df3e26af5dd5035056308bcc7f478375ef7082cad02bea83f77c99c7bb7ccf457bfca8a6c3c8b5051768df85be8a806da81fcb7005aa5246bc111c7f2eb75152fa1d32327252bdd0f1ea1fe257ed75edff1e5704e49550400ecef2e5bc985a1a21b7565f0ebe972fa14cc030ca2c5223901cadf9b7d47c78c7901742bb0ef610849088cce24f1b5afe4554ae881031079562e295ddf996a2dedcc06156f57f8d3175dfedb6ac55a0cc1d74530650e7be82fc655c08b432ea0835bdfc4a3329987bb3f6a7edebcb33ce9a0673916af8a586d16dfaae1a975add3eeb25cefc050f26c0f336ec2b182b010e243bec12d35f88326e184278eb2ab6c87e3c188d4cc7812aaa9c6c2e6a27595cb7dbe56c6a07a90b37277c579dbaaa742e8d567a8ac307feddfe78149bcdf7ff4734e79ad52674540ee0d2b0aeae790bf2d27b926ee090c9dda74d1fdbef60378a431b68c46df459a2e482db75a4a1ef862023753cd5db2bf53e4da37c7b0feeb87c972c0404665c93de3fcfc38a96bc5535d4dd4c5acf12f58b2c37e348235aa0b3293ecc0cd77cd30fb65c91aef9440b6cc2be6c18598878197e0e9939859351e38e455cbd6e162948db37543390946243ad8c68147f7495e7e9ec1a4cfde6c51bf66dbd85b07e8009cf50709dad219462974083e315ec4ffca929e4ca8478905dd23686b0e667660701503094b0fe12e2eaea1674e2558d6ea4bae0033c278f75bbfa4664ae1b4dff2cd9ada68ee493d7fd7aa93816429d807ca50aa81ff6f71d8f5a8f7ef4d4d545d65749186106e47ad804902122b05000fd0c79056675eaa9bf0eafab7677231b02e06f04f4feb5235184108b6442d9484110a683",
"success": true,
"userNo": "5181200720000136338"
}
作者:陈花枪 创建时间:2024-08-15 10:19
最后编辑:陈花枪 更新时间:2025-09-04 11:36
最后编辑:陈花枪 更新时间:2025-09-04 11:36