快速入门

本指南帮助您在约 10 分钟内通过塞拉利昂 Orange Money 收到第一笔付款，即使您从未集成过任何支付方式。

适用地区：塞拉利昂（Orange Money，利昂 — SLE）。有关币种、电话号码和付款人体验的详细信息，请阅读 在塞拉利昂集成（英文）。

---

工作原理

资金从客户的 Orange Money 钱包到达您账户的过程如下：

graph LR
    A[Your website] -- 1. Customer clicks Pay --> B(SOAMTAR)
    B -- 2. Payment request on the customer's phone --> C{Orange Money}
    C -- 3. Customer confirms with their PIN --> B
    B -- 4. Signed webhook --> A

---

第 1 步：创建账户（2 分钟）

1. 在 SOAMTAR Business 免费注册。
2. 在控制台中，进入 开发者 > API 密钥。
3. 复制您的公钥（以 pk_test_... 开头）。它在浏览器中标识您的账户。

---

第 2 步：在网站上添加按钮（5 分钟）

无需编程：复制以下代码，粘贴到您希望显示按钮的位置即可。

“复制粘贴”方式（无需编写 JavaScript）

<!-- 1. Load the SOAMTAR library -->
<script src="https://app.so-amtar.com/sdk/soamtar.js"></script>

<!-- 2. Add the payment button -->
<button
  data-soamtar
  data-soamtar-public-key="pk_test_YOUR_KEY_HERE"
  data-soamtar-amount="50.00"
  data-soamtar-currency="SLE"
  data-soamtar-description="Purchase of my product"
  style="background: #2ecc71; color: white; padding: 15px 30px; border: none; border-radius: 5px; cursor: pointer; font-size: 18px;">
  Pay Le 50.00
</button>

提示：将 pk_test_YOUR_KEY_HERE 替换为第 1 步中复制的密钥。

客户付款时，Orange Money 会向其手机发送付款请求；客户使用 Orange Money PIN 确认。

---

第 3 步：验证是否生效（3 分钟）

点击按钮并模拟一次成功付款后：

1. 返回 SOAMTAR 控制台。
2. 打开 付款 选项卡。
3. 您的交易会显示为 成功 状态。

---

上线生产环境

当测试通过、准备接收真实资金时：

1. 在控制台右上角将开关切换到 LIVE 模式。
2. 填写您的企业信息（KYC）。
3. 复制新的 pk_live_... 密钥。
4. 在代码中用 live 密钥替换测试密钥。完成。

切换之前，请先完成 上线检查清单（英文）。

---

应选择哪种集成方式？

如果您使用…	请采用…
WordPress / WooCommerce	安装我们的 WordPress 插件（无需代码）。
自定义网站（HTML）	使用上面的支付按钮。
完整的应用	使用我们的 开发者 SDK 和 Payments API（英文）。

需要帮助？

我们的工程师免费协助您集成 SOAMTAR。请通过客服联系我们！