Nigeria BankTransfer

支付方式属性

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

交易流程

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

集成

请求参数说明：

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（NGN）
├── `value`	Number	是	金额数值，单位为最小货币单位
`paymentMethod`	Object	是	支付方式信息
├── `bankName`	String	部分支付方式必填，请查看支付方式列表	银行编码，请查看下方支付方式列表
├── `cvc`	String	否	客户的银行验证号码（BVN）
├── `firstName`	String	是	付款人姓氏
├── `lastName`	String	是	付款人名字
├── `shopperEmail`	String	是	付款人邮箱
├── `telephoneNumber`	String	是	付款人手机号
├── `type`	String	是	支付方式（nigeriabanktransfer）
`countryCode`	String	是	国家代码（NG）
`origin`	String	是	订单来源，如商城域名
`productDetail`	String	是	订单描述

交易调用输入

{
     "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	否