payin商户操作手册

最新内容

设计顾客能认出的银行卡账单描述

选择容易辨认的商户前缀,计算动态后缀的字符预算,并区分 Stripe 配置值与发卡银行实际显示的文字。

发布: · 本次核验:2026-09-20 · PayIn 编辑资料

适用地区:Stripe 商户账户:银行卡付款的拉丁字符描述;日文描述仅讨论符合条件的日本商户与日本发行的 Visa/Mastercard。本文不覆盖 Connect 平台及订阅配置。

先考虑顾客认得什么,而不是内部订单编号

Stripe 将账单描述定义为银行账单上对扣款或付款的解释,并要求它反映商户对外经营名称。账户可以使用固定描述;银行卡扣款还可以组合账户前缀与交易专属后缀。[3] 编辑建议:选择前缀之前,先确认顾客在结账时记住的店铺名称。财务人员熟悉的短编号,对买家未必有意义。让可识别的商户身份保持稳定,再用剩余空间区分产品或服务。本文提出的是命名工作流程,不声称某个描述已经降低拒付率,也不把银行账单这一场景与订单系统内部的唯一标识混为一谈。

计算完整字符串,别漏掉分隔符

对于标准拉丁字符描述,Stripe 规定完整长度为 5 至 22 个字符,固定前缀为 2 至 10 个字符。描述至少包含一个字母;使用前缀和后缀时,两者都需要字母。Stripe 在前缀之后插入星号与一个空格,再接上后缀,完整组合不能超过 22 个字符。[3] 编辑建议:校验最终结果,而不是只校验后缀输入框。说明性示例,并非真实商户:NORTHSHOP 为九个字符,CLASS APR 为九个字符,合成 NORTHSHOP* CLASS APR 后连同分隔符共二十个字符。十字符的前缀只剩十字符的后缀空间。系统自动插入的星号不代表商户可以向输入组件随意加入特殊字符。

根据支付类型选择正确参数

动态后缀仅支持银行卡付款。Stripe 为 PaymentIntent 提供 statement_descriptor_suffix,为 Checkout Session 提供 payment_intent_data.statement_descriptor_suffix。银行卡付款不能指定 statement_descriptor;非卡付款则可以通过该字段覆盖固定描述。[3] 编辑建议:在集成评审中明确记录支付类型与参数的对应关系。不要因为字段名称看起来更直观,就把非卡付款示例直接复制到银行卡结账中。本文不把这些直接付款设置推广到订阅、发票或 Connect 账户,它们有单独的配置路径;也不声称 PayIn 产品接口支持相同字段。配置是否被某个服务接受,必须回到该服务自己的文档核对。

把前缀截断列入明确的审查项目

如果设置了固定描述但没有单独设置前缀,Stripe 会把固定描述用于银行卡付款前缀;超过十个字符时会将它截短。[3] 编辑建议:添加交易后缀前,先审查截短后的商户身份。顾客真正认识的部分可能恰好在被移除的末尾。维护一个经过批准的小型后缀词表,不要直接填入任意购物车文字。多商品订单应使用真实的类别说明,避免让描述看起来只购买了其中一件商品。拟议检查包括最长前缀、最长允许后缀、字母要求,以及包含分隔符的总长度。这是待执行的评审清单,不是已经通过生产测试的声明,也不能替代完整的订单收据。

别把拉丁字符规则写成全球文字禁令

Stripe 为日本商户另行支持汉字与假名描述。文档要求同时满足两个条件:卡片是日本发行的 Visa 或 Mastercard,且交易由日本商户处理或代表日本商户处理。最终显示汉字、假名还是拉丁字符,由发卡行决定。API 返回的 calculated_statement_descriptor 始终是拉丁字符描述,即使银行可以显示日文描述。[3] 编辑建议:将其视为独立的地区适用路径,而不是向标准拉丁字符字段随意填入 Unicode 的理由。业务符合该路径时,应直接查看日本描述的专门要求;不要复用拉丁字符的长度校验器后,就假定它适用于所有文字体系。中文阅读界面本身也不会改变卡片和商户的适用条件。

区分配置文字与银行展示结果

Stripe 提醒,一些银行可能错误显示账单信息,甚至完全不显示。对于日本汉字和假名描述,文档说明信息在请款时发送,通常需要几天才出现在账单中,期间可能显示临时描述。[3] 编辑建议:客服记录应分别保存配置描述、计算得到的拉丁描述,以及顾客反馈的银行显示内容。不要承诺所有银行应用都完全一致,也不要仅凭临时文字就认定配置失败。如果支持流程确实需要顾客截图,按商户自身政策只索取相关交易行,避免收集无关账户信息。这项数据最小化建议属于编辑建议,不是 Stripe 数据保留规则的转述。未知的展示原因应标注未知,而非补写未经核实的解释。

留下命名决策和诚实的验证记录

编辑建议:形成简短决策记录,列明商户身份、付款类型、前缀、允许的后缀、合成长度及文字批准人。在收据或客服材料中说明预计出现的商户名称,但不保证银行最终排版。拟议验收项目包括银行卡与非卡参数的区分、完整字符串检查、未设置前缀时的截断,以及日本适用条件的专门核对。[3] 只有实际获授权执行测试后,才能记录观察结果。本文没有发起付款、检查真实顾客账单、测量名称识别率或证明拒付率改善。合适的账单描述是一项有文档配置依据的清晰身份决策,不是付款收据或逐案客服处理的替代品。

来源与日期

本次核验日期:2026-09-20。来源日期按原页面明确标注的发布或更新时间分别列示;未标注不等于本日发布。本文为公开文档研究,未进行真实支付、安全审计或辅助技术合规认证。厂商事实仅归属于被引用厂商;流程建议为编辑综合。

  1. Stripe:账单描述 [3] ↗

    来源日期:未注明;本次核验:2026-09-20

继续阅读最新内容

把争议证据提交当作最终交付,而不是可补充的草稿 →

SCA 豁免减少认证摩擦,不等于转移欺诈责任 →

全部操作资料 →