文档

Africa Card

非洲卡支付接受大多数 Visa 和 Mastercard。Visa 是全球交易额最大的全球卡网络，遍布全球。Mastercard是全球大型信用卡组织之一，在欧洲联名信用卡市场占据主导地位。





支付方式属性

属性内容
可用国家代码尼日利亚 (NG), 加纳 (GH), 南非 (ZA), 埃及 (EG), 肯尼亚 (KE), 赞比亚 (ZM), 科特迪瓦 (CI), 喀麦隆 (CM), 塞内加尔 (SN), 乌干达 (UG), 卢旺达 (RW), 坦桑尼亚 (TZ), 摩洛哥 (MA), 阿尔及利亚 (DZ), 加蓬 (GA), 布基纳法索 (BF), 贝宁 (BJ)
消费者货币尼日利亚奈拉 (NGN)，加纳赛地 (GHS)，南非兰特 (ZAR)，埃及镑 (EGP)，肯尼亚先令 (KES)，赞比亚克瓦查 (ZMW)，科特迪瓦西法 (XOF)，喀麦隆中非法郎 (XAF)，塞内加尔西法 (XOF)，乌干达先令 (UGX)，卢旺达法郎 (RWF)，坦桑尼亚先令 (TZS)，摩洛哥迪拉姆 (MAD)，阿尔及利亚第纳尔 (DZD)，加蓬中非法郎 (XAF)，布基纳法索西法 (XOF)，贝宁西法 (XOF)
处理货币尼日利亚奈拉 (NGN)，加纳赛地 (GHS)，南非兰特 (ZAR)，埃及镑 (EGP)，肯尼亚先令 (KES)，赞比亚克瓦查 (ZMW)，科特迪瓦西法 (XOF)，喀麦隆中非法郎 (XAF)，塞内加尔西法 (XOF)，乌干达先令 (UGX)，卢旺达法郎 (RWF)，坦桑尼亚先令 (TZS)，摩洛哥迪拉姆 (MAD)，阿尔及利亚第纳尔 (DZD)，加蓬中非法郎 (XAF)，布基纳法索西法 (XOF)，贝宁西法 (XOF)
结算货币当地货币
类型 I信用卡及借记卡（Cards）
类型 IInigeriacards, ghanacards, southafricacards, kenyacards, zambiacards, ivorycoastcards, camerooncards, senegalcards, ugandacards, rwandacards, tanzaniacards, moroccards, algeriacards, gaboncards, burkinafasocards, benincards
最小交易金额1
最大交易金额取决于银行
会话超时1 小时，取决于流程
退款支持全额退款、部分退款和多次部分退款
退款有效期360 天
拒付180 天

交易流程

  1. 在线结账时，消费者选择 Visa、Mastercard 等卡作为首选支付方式
  2. 消费者输入卡片详细信息
  3. 消费者通过卡PIN、AVS、3DS、短信等验证方式验证交易
  4. 确认付款

集成

请求参数说明

参数名类型必填说明
referenceString是订单唯一标识（商户侧生成）
amountObject是订单金额信息
├── currencyString是货币类型（如 NGN）
├── valueNumber是金额数值，单位为最小货币单位
countryCodeString是国家代码（如 NG）
returnUrlString否指消费者在支付成功后，系统自动将消费者重定向到的网页地址（URL），此URL通常用于显示支付成功的确认页面，或将消费者带回到商户网站的指定页面
paymentMethodObject是支付方式信息
├── bankAccountNumberString是银行卡号/账号
├── cvcString是卡片安全码（CVV/CVC）
├── expiryMonthString是卡片有效期月份（如 10）
├── expiryYearString是卡片有效期年份（如 31，表示 2031 年）
├── holderNameString是持卡人姓名
├── shopperEmailString是付款人邮箱
├── telephoneNumberString否付款人手机号
├── typeString是支付方式类型（如 nigeriacards）

交易调用输入示例

{
  "amount": {
    "currency": "NGN",
    "value": 100
  },
  "countryCode": "NG",
  "paymentMethod": {
    "bankAccountNumber": "5438898014560229",
    "cvc": "564",
    "expiryMonth": "10",
    "expiryYear": "31",
    "holderName": "John Doe",
    "shopperEmail": "[email protected]",
    "telephoneNumber": "254712345678",
    "type": "nigeriacards"
  },
  "reference": "8C2FAD7F7CD54A259769F51FD9AE88B3-3"
}

交易响应字段说明

参数名类型必填说明
codeString是响应码，0 表示成功
msgString是响应消息，如 success
serverTimeNumber是服务端时间戳（毫秒）
successBoolean是请求是否成功标志
dataObject是业务数据
├── actionObject是支付动作信息（下一步操作）
├──── fieldsArray否需要额外输入的字段列表（如 PIN）
├──── messageString否提示信息（如 "Please enter your PIN"）
├──── methodString是请求方式（如 Post）
├──── payUrlString否支付跳转 URL（如 3DS 验证页面）
├──── paymentMethodTypeString是支付方式类型（如 nigeriacards）
├──── typeString是动作类型（如 pin，表示需要输入 PIN）
├──── urlString否支付跳转 URL（如 3DS 验证页面）
├── amountObject是金额信息
├──── currencyString是货币类型（如 NGN）
├──── valueNumber是金额数值，单位为最小货币单位
├── merchantReferenceString是商户订单号
├── pspReferenceString是支付平台订单号（PSP 生成的唯一 ID）
├── resultCodeString是支付处理结果状态（如 PENDING，表示处理中，需进一步操作）

交易调用输出示例

{
  "code": "0",
  "data": {
    "action": {
            "fields": [
                "pin"
            ],
            "message": "Please enter your PIN",
            "method": "Post",
            "payUrl": "https://checkout.futurepay-develop.com/ThreeDSAuth?reference=5A77CEC20C3C4E6D9453EDD79794A2E4",
            "paymentMethodType": "nigeriacards",
            "type": "pin",
            "url": "https://api.futurepay-develop.com/payin/chargeCard"
    },
    "amount": {
      "currency": "NGN",
      "value": 100
    },
    "merchantReference": "8C2FAD7F7CD54A259769F51FD9AE88B3-3",
    "pspReference": "1839267160225087488",
    "resultCode": "PENDING"
  },
  "msg": "success",
  "serverTime": 1751340587008,
  "success": true
}

成功的测试卡

‌类型‌‌网络‌‌卡号‌‌有效期‌‌CVV‌‌OTP‌‌PIN‌
PIN认证Mastercard‌5531886652142950‌09/32564123453310
3DS认证Mastercard543889801456022910/31564123453310
3DS认证Visa‌4187427415564246‌09/32828123453310
3DS认证Afrigo‌5640003941605320‌05/26044


PIN认证Verve‌506146041012022321010/31780123453310
无认证Verve‌5061460166976054667‌10/29564

3310
地址验证（AVS）Visa455605270417264309/32899123453310
预认证测试卡Mastercard537728364507745009/31789

3310

失败的认证卡

‌类型‌‌网络‌‌卡号‌‌有效期‌‌CVV‌‌OTP‌‌PIN‌
卡被拒绝（地址验证）Mastercard514301052233996508/32276123453310
卡欺诈Mastercard559013174329431411/32887123453310
卡余额不足Mastercard525858592266650609/31883123453310
不予承兑Mastercard514301052233996508/31276

3310
余额不足Mastercard525858592266650609/3188312345

余额不足Afrigo564000706527538005/26044


受限制卡，留卡Mastercard555165163038138408/31276


无效交易Mastercard555165815765382208/31276


功能不允许持卡人使用Mastercard525858205472902011/30887


功能不允许终端使用Mastercard525858826456568211/30887


交易错误Mastercard525858913014901611/30887


错误PINMastercard539983469789472309/31883123453310