常见问题

账户与开户

开户需要多长时间？

注册只需几分钟。KYC 材料齐全后（企业注册文件、董事身份证件、银行账户信息），我们会告知审核结果。参见 在塞拉利昂集成（英文）。

KYC 需要哪些材料？

共有三个逐级递进的验证等级，决定您可进行的操作：

等级	材料
1	已验证手机号
2	等级 1 + 身份证件 + 自拍照
3	等级 2 + 银行账户信息 + 地址证明

各等级的限额会在账户激活后显示在控制台中。

我的 KYC 被拒绝了，怎么办？

控制台会显示拒绝原因。在 KYC 页面上传更正后的材料即可。没有处罚，也无需等待。

费用

SOAMTAR 收费多少？

手续费和商业条款写在您的商户协议中，也可在控制台设置中查看。

我什么时候能收到款项？

结算时效取决于支付渠道。实际时效显示在控制台中，您也可以在那里设置最低结算金额。款项结算到您在塞拉利昂的银行账户（使用账号——塞拉利昂不使用 IBAN）。

技术

为什么应该发送 Idempotency-Key？

为了在网络超时后避免向客户重复扣款。如果没有显式提供密钥，SOAMTAR 会根据您的 merchant_ref 推导一个；发送您自己的密钥可以让您精确控制。参见 幂等性（英文）。

我的 Webhook 端点应该返回什么？

在几秒内返回任意 2xx 即可。响应体会被忽略。返回其他状态码或超时都会触发重试。

Webhook 会重试几次？

最多 5 次尝试：首次投递，之后分别在 60 秒、5 分钟、30 分钟和 2 小时后重试。连续多次失败后，该端点会被停用，并会收到邮件通知。

如何手动重发 Webhook？

控制台 → Webhooks → 日志 → 在相应行点击 Resend。

可以设置多个 Webhook 端点吗？

可以。每个端点都有独立的密钥和事件筛选。

丢失 Webhook 密钥怎么办？

在控制台中轮换密钥；新密钥只显示一次。您也可以使用私钥调用 GET/v1/webhooks/{endpoint_id}/secret 获取（在控制台中，live 模式下受 OTP 保护）。

测试密钥和 live 密钥能看到相同的数据吗？

不能。每个密钥只能看到其所属模式下的对象：测试密钥无法读取 live 对象，反之亦然。

能否在生产环境中重放沙盒交易？

不能。两个环境中可以存在相同的 merchant_ref（唯一性按模式区分），但标识符不同。

电话号码使用什么格式？

E.164：+232 加上 8 位国内号码，例如 +23276000001。不含空格或连字符。出款要求带有开头的 +。

业务场景

没有后端如何使用托管收银台？

在控制台中创建支付链接。该 URL 可直接分享（WhatsApp、短信、邮件）。

塞拉利昂的客户能用美元或欧元付款吗？

API 接受 SLE、USD 和 EUR。塞拉利昂 Orange Money 以利昂收款；当请求的币种不同时，汇率在发起付款时锁定。

每笔交易可以分账给多少方？

支持多个收款方。如收款方数量较多，请联系客服。

能否对 Orange Money 付款进行退款？

可以。调用 POST/v1/refunds 并传入付款的 transaction_id（部分退款时可传入可选的 amount；不传则退还全部剩余金额）。款项会退回到付款人的 Orange Money 号码并从您的余额中扣除；结果通过 refund.success / refund.failed webhook 通知。参见退款（英文）。

能否用 Orange Money 支付订阅？

目前还不支持自动扣款：移动货币令牌化尚不可用。订阅可以通过在每个计费周期向客户发送付款请求来实现。

如何取消订阅？

DELETE/v1/subscriptions/{id}（立即生效）或 ?at_period_end=true（在当前周期结束时生效）。

合规

SOAMTAR 受监管吗？

SOAMTAR 在塞拉利昂运营，以塞拉利昂 Orange Money 作为支付渠道，并实施反洗钱（AML）控制（交易监控、可疑活动报告）。监管相关信息可应机构商户的要求提供。

商户资金受保护吗？

待结算资金记录在专用账户中，与公司运营资金分开。

SOAMTAR 会保存 Orange Money 密码吗？

不会。SOAMTAR 使用 Orange Money 的商户 API 及专用凭据，从不使用您付款人的 PIN 或登录凭据。

帮助

如何联系客服？

• 邮件：support@so-amtar.com
• 控制台在线聊天：工作时间内可用（弗里敦时间，GMT）