Laravel网页项目通过JS集成Affirm支付网关时执行checkout流程报错
Laravel项目接入Affirm Web支付Checkout异常排查方案
问题基础背景
- 站点基于Laravel框架搭建,通过前端JavaScript接入Affirm支付能力,在执行checkout环节时触发异常报错
- 已参考同类开源项目的历史问题反馈,定位到已知触发场景为checkout请求体任意位置包含撇号会引发这类报错,已移除请求体中存在的1处撇号,但报错问题仍然存在
- 排查过程全程对照Affirm官方Checkout Web API文档做参数校验,报错表现可对应提供的截图信息
可落地排查步骤
- 逐字段核对checkout请求体的结构合规性:重点检查收货信息、账单信息、商户配置这些嵌套模块的字段命名有没有拼写错误,所有金额字段必须传以分为单位的整数数值,绝对不能传带货币符号的字符串、小数格式的金额值
- 排查后端接口输出的字符转义残留:Laravel默认用
json_encode输出数据时,会自动把单引号、非中文字符转义成不可见的十六进制格式,前端把这类内容拼进checkout请求体时,会被Affirm接口判定为非法字符。输出给前端的接口数据要在json_encode时加上JSON_HEX_APOS | JSON_UNESCAPED_UNICODE参数,从根源避免转义残留 - 核对JS SDK和密钥的环境匹配性:确认页面引入的Affirm JS SDK域名,和当前用的公钥所属环境是对应的,测试环境不能直接套生产环境的公钥,反过来生产环境也不能用测试公钥,环境不匹配会直接在唤起checkout的环节抛错
- 检查商户模块的必填字段完整性:确认checkout请求里商户相关的字段没有空值,尤其是用户确认跳转链接、取消跳转链接这类字段,必须填带完整http/https协议的绝对地址,不能填站点内的相对路径
- 全量扫描请求体里的特殊字符:之前只排查了撇号,还要把请求体所有文本字段过一遍,看看有没有emoji、全角标点、没闭合的引号这类内容,Affirm接口对非ASCII字符的编码校验很严格,编码不对的内容会直接返回400类错误
内容的提问来源于stack exchange,提问作者Shahrukh Siddiqui
相关产品推荐
相关产品推荐

