如下图所示为 Ping++ 提供的开发联调工具,以下解释说明这些工具作用以及如何使用。
①服务端 charge 格式验证
用于验证你服务端返回给客户端的 charge (支付凭据)格式是否正确(如图1)。
首先需要输入你服务端生成 charge 的 URL ,然后选择 application/json 或者 application/x-www-form-urlencoded 并填写对应格式的请求参数并提交,则可以看到你服务器返回的结果了;如果你服务器返回格式不正确,联调工具会提示错误信息。
图 1
②Webhooks 通知查询工具
用于 test / live 模式下查询或确认你服务器是否收到 Ping++ webhooks 通知(如图2)。
当你发现自己服务器没有收到 Ping++ webhooks 通知或需要确认实际发送情况以及原因时,先选择需要查询事件的类型、webhooks 发送地址,再在下侧查询条件搜索框输入商户订单号或者 Ping++ 流水号进行查询。
该工具包含的查询结果为:webhooks发送时间、发送的状态以及内容、发送了几次、你响应的内容和状态码。如果想了解更多的信息,你可以点击【详情】。详情中包含“ Ping++ Webhooks Request ”和“ Your Response ”(如图3)。当然,如果出现你自己服务器响应问题后,你依然想重新触发 webhooks 发送以更新自己的订单状态的话,可以点击 【重新发送】 按钮来触发。
图 2
点击【详情】后
图 3
③请求 log 日志查询工具
用于你查询针对现登录的 Ping++ 账号对应的公司账户下对应的 app 在一定条件下,你的服务端请求 Ping++ 的日志记录。
你可以选择【组合搜索】或者【精确搜索】。
【组合搜索】中,你可以查询某一段时间内的请求日志,请求概要信息包括:“请求时间”、“请求地址”、“响应状态码”、”请求 IP“、“请求方法”(如图4)。查询出来的 list 中每条记录都可以点开查看详情,详情中还有更加具体的请求信息(如图5)。
【精确搜索】中,你可以查询某一笔订单的请求日志,你需要输入 Ping++ 流水号,请求概要信息包括:“请求时间”、“请求地址”、“响应状态码”、”请求 IP“、“请求方法”(如图6)。查询出来的 list 中每条记录都可以点开查看详情,详情中还有更加具体的请求信息(如图5)。
该日志查询工具方便开发者查询 Ping++ 接口响应时间,在自己本身日志记录不完全的情况下,也可以在调试阶段使用 Ping++ 的日志查询工具查看每条记录具体的请求参数和响应的信息,方便排错等等。在加载更多时,如果出现【数据处理中,请稍后重试】的提示,请等待一段时间,稍后继续加载更多数据。
图 4
图 5
图 6
④Webhooks 测试
用于你测试你服务器的连通性以及你服务器是否正确返回以及签名验证的工具。
该工具在 webhooks 配置的页面,点击【测试】, Ping++ 就向你配置的 webhooks 地址主动发送通知(如图 7)。
图 7