尼日利亚银行列表
验户前读取当前支持的尼日利亚银行列表，避免在企业系统中长期写死银行代码。
NGN付款接口与奈拉代付 API
NGN付款接口：面向企业服务器的尼日利亚奈拉代付 API
Elephant FX 为通过审批的企业服务器集成提供 NGN 付款接口。开发团队可先在隔离 Sandbox 中测试银行列表、收款账户验户、幂等付款提交、状态查询和签名 Webhook。生产接入须完成企业审核、生产应用审批、授权 Scope 及服务器来源 IP 配置；接口返回 RECEIVED、PENDING_REVIEW 或 PROCESSING 时均未最终完成，只有 COMPLETED 表示最终付款成功。
NGN付款接口能力
收款账户验户
提交付款前校验 10 位尼日利亚银行账号，并核对银行返回的真实账户姓名。
幂等付款提交
使用唯一 Idempotency-Key 和商户参考号提交 NGN 付款，降低网络重试导致重复付款的风险。
付款状态查询
持续查询原付款直至明确终态，不将已接收、待审核或处理中误判为到账成功。
签名 Webhook
通过验签、时间戳校验和事件去重接收付款状态通知，并保留轮询作为核对手段。
凭证与企业对账
对已完成付款获取可用凭证，并结合 payoutId、商户参考号和业务单据完成企业对账。
从 Sandbox 到生产的接入流程
1
创建 Sandbox 应用
登录开发者中心创建隔离测试应用，将仅显示一次的 Client Secret 保存到服务端密钥管理系统，不放入网页或移动端。
2
完成接口验收矩阵
在申请生产接入前，验证成功、处理中和失败结果，以及幂等重放、状态轮询、凭证下载和 Webhook 验签。
3
申请生产接入
完成企业审核，提交生产应用和固定服务器公网 IP；审批通过后先进行小额真实付款验收，再按批准范围逐步放量。
奈拉代付 API 常见问题
哪些企业可以使用 NGN 付款接口？+
接口面向具有真实尼日利亚付款需求并通过审核的企业集成。生产环境是否可用取决于企业审核、批准的业务场景、应用审批、授权 Scope、限额和当时银行通道可用性。
Sandbox 会连接真实资金和银行通道吗？+
不会。Sandbox 与真实钱包、外部银行通道和真实资金隔离，测试凭证不能访问生产环境。
生产接口需要哪些条件？+
生产接入需要完成企业审核、生产应用审批，并使用有效生产凭证、批准的 Scope 和匹配的固定来源 IP；已批准账户还可能适用单笔、日度、月度限额或其他控制。
哪个接口状态代表付款最终成功？+
只有 COMPLETED 表示最终成功。RECEIVED、PENDING_REVIEW 和 PROCESSING 均为非终态；应继续查询原付款或核对签名 Webhook，不要因此创建第二笔付款。
NGN 付款接口如何降低重复付款风险？+
每笔业务付款应使用唯一 Idempotency-Key 和商户参考号；使用同一 Key 重试时请求体必须保持一致，并应查询原 payoutId 直至确认最终状态。
所有接口客户的费用和限额都一样吗？+
不一样。提交前应读取已批准应用当前生效的付款设置；费用、限额、已用额度和银行可用性以企业账户及当时服务配置为准。
合规说明
安全、可追踪的交易服务
Elephant FX 通过账户认证、交易监控、安全出款控制和审计记录，为以尼日利亚为核心的入境汇款与付款服务提供稳健保障。