综合

支付 API:如何将 Pix、银行卡和 boleto 接入您的系统

支付 API 指南:它是什么、集成如何进行,以及如何在巴西直接从您的网站、App 或系统通过 Pix、信用卡和 boleto 收款。

作者 Equipe Sila Pay阅读约 1 分钟
两位面带微笑的同事在小办公室里的笔记本电脑旁交谈

支付链接可以完成很多销售,但业务发展到一定阶段就需要更多:直接在网站、App 或 ERP 中收款,无需手动复制粘贴。这时就需要支付 API。

什么是支付 API

API(应用程序编程接口)是您的系统与支付平台之间的通信通道。借助它,您的软件可以通过 JSON 格式的 HTTP 请求自动创建收款、跟踪状态并接收确认。

集成步骤

  1. 注册账户并生成密钥:在 Sila Pay 后台的 API Key 菜单中生成您的 api-key 和 secret-key,每次请求都在请求头中携带。
  2. 创建收款:您的系统向 https://api.silapay.pro/v1/transactions 发送 POST 请求,包含金额、客户信息和付款方式(pix、creditCard 或 billet)。
  3. 向客户展示付款信息:Pix 的响应中包含"复制粘贴"付款码;boleto 会按您设定的到期日开具;银行卡则返回交易结果。
  4. 接收确认:填写 postbackUrl,付款状态变化时,您的系统会通过 Webhook 收到通知。

Pix、银行卡和 boleto 的区别

  • Pix:收款创建后状态为待支付,并附带"复制粘贴"付款码;一旦识别到付款,确认就会通过 Webhook 送达。
  • 信用卡:支持分期付款(在请求中填写期数),并可将客户跳转到支付成功页面(successUrl)。
  • Boleto:由您设定到期日,并可传入自己的参考号(externalReference),将收款与订单关联。

通过 API 集成的优势

  • 体验由您掌控:您决定收款在何处、以何种方式展示给客户。
  • 减少人工操作:订单自动创建、自动确认。
  • 一次集成,三种付款方式:Pix、银行卡和 boleto 使用同一个接口。
  • 随业务一起成长:无论每天订单多少,都可以使用同一套流程。

想把支付接入您的系统吗?注册 Sila Pay 账户

集成最佳实践

  • 密钥只放在服务器:切勿将 api-key 和 secret-key 放在前端或 App 中;所有调用都应从您的后端发起。
  • 验证 Webhook:在将订单标记为已付款前,先核验 X-Silapay-Signature 请求头。
  • 保存交易 ID:将 API 返回的 id 与您系统中的订单关联。
  • 处理错误和超时:给出清晰的提示,并允许客户重试而不产生重复收款。
  • 先用小额测试:在向所有客户开放前,完整测试整个流程。

常见问题

需要开发人员吗?

通过 API 集成的话,需要:必须有人在您的系统中编写调用代码。如果您使用 WooCommerce 或 Shopify,Sila Pay 插件是更简单的选择;如果没有网站,用支付链接即可。

文档在哪里?

请访问 doc.silapay.pro,其中介绍了 Pix、银行卡、boleto、余额和 Webhook 的调用方式,并附有请求和响应示例。

API 只能用来收款吗?

不是。除了创建收款,文档还介绍了 Pix 付款(cash-out)和余额查询。

需要巴西公司(CNPJ)吗?

在 Sila Pay,您可以以个人或企业身份销售;注册流程会说明每种情况所需的文件。

用一个 API 接入 Pix、银行卡和 boleto。注册 Sila Pay

#pagamentos#vendas online
分享WhatsAppLinkedInX

准备好付诸实践了吗?

几分钟内创建 Sila Pay 账户,开始通过 Pix、银行卡和支付链接收款。

  • ✓ 免费注册
  • ✓ 无月费
  • ✓ D+1 到账
免费创建账户 →

订阅最新文章

关于支付和在线销售的实用内容,直接发送到您的邮箱。

没有垃圾邮件,可随时退订。

延伸阅读

Sila Pay

销售所需的一切, 尽在一处。

立即开始 →