首页 / 巴西 PIX

巴西 PIX 支付系统搭建

你从巴西持牌机构拿到 PIX 的商户参数之后,我们把这种方式接到支付系统里:收银台、下单、验签、掉单补查、退款和对账样例。结算仍按你和该机构的合同走。

深蓝布面上的空白卡片和一枚没有文字的铜柱
只接入机构已经开通的方式。

接入范围

默认从 PIX 开始。机构文档里还有其他已开通的巴西本地方式,再按清单加上。没开通的方式不出现在收银台。

金额单位、超时和退款规则按这份文档核对,不用另一个国家的接口习惯硬套。

系统落在哪里

可以接在 租来的支付系统 上,也可以接在你现有的订单系统上。同一笔订单只由一个系统改状态。

参数还没下来时,可以先部署系统,PIX 联调往后排。

开工前要到齐的材料

完整说明见 《巴西 PIX 支付系统搭建前要准备的材料》。

主体与授权

你有可签约的主体,并有权把商户参数交给我们做对接。

商户参数

商户号、密钥、沙箱与生产环境。

通知地址

回调要求和你的通知 URL。域名由谁持有先说清。

方式与退款

已开通方式的清单,以及 PIX 能否退款、能否部分退款。

对账样例

一笔真实格式的文件,标出订单号、金额、币种、状态和手续费。

结算约定

币种和周期以机构合同为准。系统负责记录。

沙箱里要走通的四条

01成功

一笔最小金额支付成功,订单、通知和对账样例的编号一致。

02失败

用户取消或机构拒绝时,订单关闭。

03重复通知

同一条回调来两次,只入账一次。

04退款

退款单号、原订单号和机构退款号能在后台对上。

关于巴西项目

PIX 之外还接别的巴西方式吗?

以机构已经给你开通的为准。常见是 PIX。文档里还有 boleto 或其他方式并且已经开通,就一并接上。没开通的不放上收银台。

你们能提供巴西收款账户吗?

不能。商户号、密钥和结算账户来自你签约的巴西持牌机构。我们用这些参数完成系统搭建。

金额用雷亚尔还是分?

以该机构的文档为准。联调用一笔最小金额核对,不沿用别的国家的小数习惯。

有商户参数就可以约联调

还没有参数,也可以先问系统部署。我们不代开巴西收款账户。

谈巴西搭建