Nigeria BankTransfer

Nigeria BankTransfer 是尼日利亚本地银行间转账服务,支持通过账户号码(Account Number)和银行代码(Bank Code)进行实时或延迟资金划转,适用于电商、汇款等场景。





支付方式属性

属性
可用国家代码尼日利亚(NG)
消费者货币NGN
处理货币NGN
结算货币NGN
类型 I银行转账 (bankTransfer)
类型 II请查看下方支付方式列表
最低交易金额无限制
最高交易金额取决于银行
会话超时1小时
退款不支持
退款有效期不支持
拒付不支持
集成类型异步

交易流程

  1. 消费者在商家结账时选择使用 Nigeria BankTransfer支付。
  2. 商户系统将付款请求转发给 Future Pay。
  3. Future Pay向Nigeria BankTransfer发起支付请求。
  4. 在Nigeria BankTransfer响应后,Future Pay将响应转发给商户。
  5. 消费者确认付款后,Nigeria BankTransfer通知支付成功结果到Future Pay。
  6. Future Pay向商户发送成功通知,商户通知消费者支付成功。

集成

请求参数说明:

参数名类型必填说明
referenceString订单唯一标识
amountObject订单金额信息
├── currencyString货币类型(NGN)
├── valueNumber金额数值,单位为最小货币单位
paymentMethodObject支付方式信息
├── bankNameString部分支付方式必填,请查看支付方式列表银行编码,请查看下方支付方式列表
├── cvcString客户的银行验证号码(BVN)
├── firstNameString付款人姓氏
├── lastNameString付款人名字
├── shopperEmailString付款人邮箱
├── telephoneNumberString付款人手机号
├── typeString支付方式(nigeriabanktransfer)
countryCodeString国家代码(NG)
originString订单来源,如商城域名
productDetailString订单描述

交易调用输入

{
     "amount": {
          "currency": "NGN",
          "value": 100
     },
     "countryCode": "NG",
     "origin": "xyz.com",
     "paymentMethod": {
          "bankName": "1067",
          "cvc": "4325",
          "firstName": "fdasff31",
          "lastName": "423441",
          "shopperEmail": "[email protected]",
          "telephoneNumber": "23455553244",
          "type": "nigeriabanktransfer"
     },
     "productDetail": "debug产品描述信息",
     "reference": "91114279C6AA416B87666E9ED1DAED6B"
}

交易调用输出

{
     "code": "0",
     "data": {
          "action": {
               "paymentMethodType": "nigeriabanktransfer",
               "type": "banktransfer"
          },
          "amount": {
               "currency": "NGN",
               "value": 100
          },
          "merchantReference": "91114279C6AA416B87666E9ED1DAED6B",
          "order": {
               "account": "3010013781",
               "accountName": "fdasff31 ffs",
               "bank": "78 FINANCE COMPANY LIMITED",
               "expiresAt": "2025-06-05 08:02:25",
               "node": "Virtual Account generated successfully"
          },
          "pspReference": "1930528116552368128",
          "refusalReason": "Virtual Account generated successfully",
          "resultCode": "PENDING"
     },
     "msg": "success",
     "serverTime": 1749108766179,
     "success": true
}

支付方式列表

支付方式

是否必填

支持的银行编码

对应银行名称(按顺序)

nigeriabanktransfer

1067、117

78 FINANCE COMPANY LIMITED、FIDELITY BANK LIMITED

nigeriabanktransfer2