Adyen付款列表里PSP reference与Merchant reference各用来做什么

在Adyen Customer Area的付款列表里,PSP reference是Adyen为这笔付款生成的唯一16字符参考号,Merchant reference是你自己为这笔付款设定的参考号。两者最直接的分工是:在Adyen侧定位和打开某笔付款时认准PSP reference;在自己的订单系统、账目或对账表里找回这笔付款时,用Merchant reference。根据Adyen文档对该页面的字段说明,付款列表中每笔付款会显示PSP reference、Merchant reference、Account、Date、Amount、Payment method、Status和Risk score等信息,其中PSP reference被描述为“Adyen's unique 16-character reference for this payment”,Merchant reference则是“Your reference for this payment”。

PSP reference、Merchant refer、查单字段
本文涉及的概念与核对环节。

这个区别在实际核对中很关键。付款列表里同一商户账户下会有大量记录,金额、日期甚至支付方式都可能重复,单靠这些字段很难锁定某一笔。PSP reference由Adyen生成且唯一,适合作为在Adyen侧定位单笔付款的入口;Merchant reference来自你自己的系统,适合把你的订单号、账单号或内部流水号与Adyen记录对应起来。需要说明的是,“前者负责在Adyen侧精确定位、后者负责在你的业务侧建立关联”是本文给出的使用建议,并非文档对两者关系的明确规定;文档只分别说明了两个字段各自的含义。

一个可执行的核对动作是:登录Customer Area,进入Payments > Payment list,找到目标付款后,先记下该行的PSP reference,再记下同一行的Merchant reference。随后点击该笔付款的PSP reference,进入Payment details页面,查看Payment lifecycle(该付款经历过的状态历史)和Payment events。文档说明,Acquirer Reference Number(ARN)可以在Payment events中找到,用于追踪退款。核对时可以用这个顺序:先用Merchant reference在自己的订单记录里确认是哪一笔业务,再在列表中按PSP reference定位并打开详情页确认状态和事件,最后在需要追踪退款时到Payment events里取ARN。这样做的目的是避免把两笔金额相近的付款混淆。

可以做一个明确假设的可复算例子。假设你的系统给某笔付款设定的Merchant reference是“ORDER-2024-0187”,你在付款列表里按这个字符串找到对应行,记下该行的PSP reference——按文档说明,它是一个16字符的唯一参考号。此时你手上有两个号:Merchant reference对应你的订单,PSP reference对应Adyen的这笔付款记录。若后续需要确认这笔付款是否发生过状态变化,用PSP reference打开Payment details,查看Payment lifecycle中的状态序列;若需要追踪这笔付款相关的退款,到Payment events中找ARN。这个例子只演示两个参考号如何配合使用,不涉及具体金额、费率或处理时限,文档只说明了字段含义和页面入口,没有给出这些数值,因此不在此基础上推算任何结论。另需注意,付款列表中的Status是Adyen记录的状态,不等同于客户到账、风控判定或发卡行的承诺。

还需要注意页面上的两个操作边界。其一,付款列表可以按商户账户筛选:文档说明Account字段表示该付款经由哪个商户账户处理,若只想看某个商户账户的付款,需切换到该商户账户。这意味着PSP reference和Merchant reference都是在具体商户账户的上下文里查看的,切换账户后看到的列表范围会变化。其二,导出完整付款列表为CSV时,使用右上角的Export,且需要具备Export Payments用户角色;文档只说明该角色要求,没有展开角色配置细节,因此这里只把它作为导出前的权限检查点。

总结成一句可记的规则:PSP reference是Adyen侧的唯一16字符定位号,用来在付款列表和详情页中锁定单笔付款;Merchant reference是你自己的参考号,用来把你的业务记录与这笔付款对上。查单时先用Merchant reference认业务,再按PSP reference定位并查看详情;需要追踪退款时,到Payment details的Payment events里找ARN。

原始资料

docs.adyen.com

上一篇 Adyen账户更新器为何依赖Tokenization服务