接入 Pix 前，先确认三件事：你的经营主体能否使用所选支付服务商、系统依据什么确认已付款，以及异常款项由谁处理。 能生成二维码，只能证明付款入口已经接通；上线验收还要覆盖通知延迟、订单超时、重复付款、退款和对账。
本文面向在巴西经营或向巴西客户销售商品、准备采购或改造电商系统的企业。讨论普通单次订单付款，不把订阅扣款、跨境结算或多商户分账默认包含在同一个“支持 Pix”的承诺里。
先确认收款主体和服务商条件
把企业注册地、销售商品、收款账户和目标客群交给候选服务商核对，再确定软件对接范围。不要先买插件，再发现账户或业务类型不适用。
例如，Stripe 的 Pix 文档列明了支持的账户所在地、业务限制和 BRL 展示币种。它支持部分境外企业收取巴西客户的 Pix 付款，但这不能推导成所有境外主体都可开通，也不能套用为其他服务商的条件。
询价时要求对方书面回答：
由哪一家企业签约和收款？本地公司与境外主体分别需要哪些材料，谁负责核验？
当前账户、商品类别和预期订单金额是否适用？是否还需要单独开通或审批？
买家支付币种、商户结算币种、资金可用时间和银行到账安排分别是什么？
单笔支付、退款、提现及换汇涉及哪些费用？按什么版本的报价和协议执行？
现有商城、插件及其版本是否支持这家服务商的当前接口，后续升级由谁维护？
比较成本时，用相同订单金额和退款比例向各家询价，拆开支付费用、结算费用、换汇成本及系统维护费。没有拿到适用报价前，不宜给所有企业套用一个“Pix 费率”。
把已付款与可发货分开判断
建议电商后台分别保存商城订单号、服务商支付编号、金额、币种和支付状态。收到可信的服务端结果并核对对应订单后，才能把订单标为已付款；随后再按库存、地址和风控规则判断是否可以发货。买家截图、手机上的完成提示和返回商城页面，都不应单独触发发货。
这里的 Webhook 是支付服务商主动发送给商城的状态通知。以 Stripe 的通知说明为例，事件可能重复送达，也不保证按产生顺序到达。因此，验收时要检查重复通知不会重复发货，旧通知不会把已付款状态退回待支付；通知来源也要按服务商要求验证。
付款确认、发货和退款是不同环节。图中为采购验收流程示意，具体状态名称按服务商和商城方案映射。
正常流程可以写为：创建待支付订单 → 展示付款信息 → 接收并核实支付结果 → 标记已付款 → 通过履约检查后发货。通知暂未收到时，订单应留在待核实状态，并具备查询和人工跟进入口。
对齐付款有效期和库存预留
软件供应商需要说明两个时间：支付凭据何时失效，商城何时取消订单、释放库存。这两个时间可能由不同系统控制，不能只在页面上放一个倒计时就认为已经一致。
要求供应商演示：买家接近截止时间付款，通知却在订单关闭后才到达，系统怎样处理？建议重新查询并核对支付结果；确有收款时，应进入异常处理，按库存情况决定恢复履约或退款，而不是自动忽略款项，也不是不经检查就复活订单。
如果买家重新下单或重新生成付款信息，保留每次支付尝试与原订单的关联。旧尝试对应的通知到来时，要能查清是哪一笔钱。页面上的“我已付款”按钮只能触发核查，不应直接把状态改成成功。
手机端也要实际走一次购买流程：葡萄牙语提示是否清楚，复制付款信息和切换银行应用是否顺畅，返回商城后能否看到经过核实的最新状态。不要只在桌面浏览器演示二维码。
退款和结算要有独立记录
“买家已付款”“服务商已确认收款”“资金已结算到商户银行账户”应能分别核对。实时支付的体验不能直接等同于商户在任何收款方案下都能立即提取资金。
退款同样需要区分申请、处理中、成功和失败。例如，Stripe 的 Pix 说明支持全额及部分退款，并明确退款请求成功不等于客户账户已到账。具体窗口与处理条件要按所选服务商核实，不能把单家规则写成 Pix 的统一承诺。退款能力与状态说明
采购时还应要求退款关联原支付，记录申请人、原因、金额和结果；累计退款不能超过该笔实际可退金额。财务需要按订单与支付编号核对收款、退款、费用及实际结算，差异留给指定负责人处理。多商户业务还要另外核实退款与商家分账的关系，不能只增加一个 Pix 按钮。
用六个场景验收，而不只看付款成功
以下金额均为演示数据，先在服务商支持的测试环境演练；生产验证的金额与操作由企业自行批准。
正常支付 R$120：金额、币种和订单关联正确；一次付款只生成一次履约任务。
同一成功通知重复到达：系统保留必要记录，但不重复发货、不重复记销售额。
买家已付，通知延迟：客服可查询并核实支付，不要求客户再次付款来“修复”订单。
订单关闭后确认收到款项：显示需处理的收款记录，核对库存后决定履约或退款，并保留处理人和原因。
同一订单出现两笔成功付款：保留两个支付编号，只履约一次；多收款进入退款处理，而不是被覆盖或静默抵扣其他订单。
申请部分退款 R$30：付款、退款和剩余金额可对账；失败或结果待定时不显示已退，重复点击不会重复退款。
把每项结果记为“现成支持、需配置、需开发、不支持”，并附演示证据、责任人和交付时间。上面属于软件验收建议，不代表 HUACODE 或某家支付服务商已经提供全部能力。
先拿到接入确认，再确定开发报价
向软件供应商提供收款主体、服务商确认结果、商城模式、订单流程和六个测试场景。报价至少区分付款入口、状态通知与核查、退款后台、财务对账、测试上线以及后续维护，避免把异常处理全部留到上线后另算。
如果需要与 HUACODE 讨论巴西电商与 Pix 接入需求，可提交脱敏的业务流程和已确认的服务商条件。先确定“谁收款、何时可发货、异常由谁处理”，再选择商城或开发方案。
资料核查日期：2026年11月2日。服务商条件以账户实际可用能力和现行协议为准；示例金额及流程用于采购验收。