常见问题

欢迎来到Smilepayz常见问题部分。在这里您将找到关于我们支付网关服务最常见问题的答案。

---

🔧 账户管理

如何获取生产环境账户号码？

生产账户设置

按照以下步骤从商户后台获取您的生产环境账户号码。

1. 登录 商户后台
2. 导航到 Finance → Balance 菜单
3. 切换 Payin 和 Payout 表格以获取不同的账户号码
4. 收款账户: 用于收集所有收款交易的资金
5. 账户结构: 每个商户每种货币有两个账户（收款和付款）
6. 账户转账: 您可以在收款和付款账户之间转账
   • 查看转账指南获取详细说明

---

📋 API参数

请求参数中的 M、C 和 O 是什么意思？

符号	含义	描述
M	Mandatory	所有请求的必需参数
C	Condition	仅在特定场景下必需
O	Optional	可选参数

什么是 minify(body)？

JSON压缩

minify(requestBody) 将请求参数转换为JSON字符串，并删除换行符、空格和其他转义字符。

• 目的: 创建用于签名生成的紧凑JSON字符串
• 实现: 我们为各种编程语言提供 minify 演示
• 参考: 查看签名工具获取实现示例

---

🇧🇷 巴西支付方式

什么是PIX？

即时支付系统

PIX是巴西中央银行推出的巴西即时支付系统。

• 类型: 巴西的即时支付方式
• 特点:
  • 24/7实时资金转账
  • 二维码支付完成
  • 即时结算
• 可用性: 每天24小时，包括周末和节假日

什么是CPF和CNPJ？

文档类型	全名	描述	格式
CPF	Cadastro de Pessoas Físicas	个人纳税人ID	11位数字
CNPJ	Cadastro Nacional da Pessoa Jurídica	企业纳税人ID	14位数字

参考:

• CPF维基百科
• CNPJ维基百科

巴西支付方式格式

方式	格式	示例	描述
PHONE	+55 + 11位数字	+5511999999999	手机号码
CPF	11位数字	12345678909	个人身份识别
CNPJ	14位数字	12345678000199	企业身份识别
EMAIL	电子邮件格式	[email protected]	电子邮件地址

---

🚀 环境迁移

如何从沙盒环境迁移到生产环境？

迁移前提条件

确保您的沙盒集成已完成且回调正常工作，然后再迁移到生产环境。

迁移步骤:

1. 更新域名

   - https://sandbox-gateway.smilepayz.com
   + https://gateway.smilepayz.com
   

2. 更新凭据

   • 将商户ID从沙盒切换到生产环境
   • 将商户密钥从沙盒切换到生产环境

3. 安全配置

   • 重新配置生产环境的RSA密钥
   • 将生产服务器IP添加到白名单

最佳实践

在迁移到生产环境之前，在沙盒环境中彻底测试，确保顺利过渡。

---

🛒 结账页面开发

如何创建自己的结账页面？

自定义结账实现

在使用Smilepayz支付处理的同时创建个性化的结账体验。

实现步骤:

1. 目的: 结账页面用于收款交易
2. 忽略支付URL: 不要使用API返回的支付URL
3. 提取数据: 从API响应中获取 qrString 或 Va number
4. 创建界面: 构建您自己的结账页面设计
5. 显示支付信息: 显示二维码或VA号码以及支付说明
6. 完成: 您的自定义结账页面已准备就绪！

---

🇮🇩 印尼特殊情况

印尼Mandiri VA的特殊处理

Mandiri VA处理

Mandiri VA需要特殊处理以避免支付失败。

API模式实现

如果您选择API模式并直接获取VA用于结账页面，请注意：

原始VA格式: 146156926294

支付方式:

支付方式	VA格式	说明
M-Banking Mandiri	146156926294	选择多支付 → "i+Pay or 70017"
其他M-Banking	88017146156926294	添加 88017 前缀，选择转账银行 → Bank Mandiri (008)

重要说明

只有Bank Mandiri可以处理原始VA格式。其他银行需要 88017 前缀。