Touch ‘n Go eWallet(Alipay+)

支付方式属性

字段名称	内容
可用国家代码	马来西亚 (MY)
消费者货币	马来西亚林吉特 (MYR)
处理货币	澳元 (AUD), 加元 (CAD), 瑞士法郎 (CHF), 人民币 (CNY), 欧元 (EUR), 英镑 (GBP), 港元 (HKD), 日元 (JPY), 纽元 (NZD), 新加坡元 (SGD), 美元 (USD)
结算货币	澳元 (AUD), 加元 (CAD), 瑞士法郎 (CHF), 欧元 (EUR), 英镑 (GBP), 港元 (HKD), 日元 (JPY), 纽元 (NZD), 新加坡元 (SGD), 美元 (USD)
类型 I	电子钱包 (wallet)
类型 II	`tng`
最小交易金额	0.05 MYR
最大交易金额	20,000 MYR/笔；25,000 MYR/月；300,000 MYR/年
会话超时	10 分钟，取决于流程
退款	支持全额退款、部分退款和多次部分退款
退款有效期	365 天
拒付	无
集成类型	异步

交易流程

在商家结账页面，消费者选择使用Touch ‘n Go eWallet(Alipay+)付款。
商户向Touch ‘n Go eWallet(Alipay+)发送交易请求。
如果消费者通过桌面浏览器付款：
1. 消费者被重定向到Touch ‘n Go eWallet(Alipay+)页面
2. 消费者可以扫描二维码，或者登录Touch ‘n Go eWallet(Alipay+)网站进行支付。
如果消费者通过移动设备付款：
1. Touch ‘n Go eWallet(Alipay+)向商户的移动网站返回支付链接。
2. 商家的移动网站将消费者重定向到Touch ‘n Go eWallet(Alipay+)应用内支付页面。
3. 消费者在Touch ‘n Go eWallet APP上完成支付。

集成

请求参数说明：

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如MYR）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 MY）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `holderName`	String	否	持卡人姓名
├── `shopperEmail`	String	否	付款人邮箱
├── `type`	String	是	支付方式（如 tng）
`returnUrl`	String	是	支付完成后返回的 URL
`browserInfo`	Object	否	设备浏览器信息（如不指定该信息，则会获取userAgent信息判断消费者终端信息）
├── `osType`	String	否	操作系统类型（如 IOS, ANDROID,OTHER）
├── `terminalType`	String	否	终端类型（如 APP, WAP,WEB,MINI_APP）
`shopperReference`	String	是	付款人唯一标识

交易调用输入

{
    "reference": "9B6F974D3DB8436AA2B139551933FF08",
    "amount": {
        "currency": "MYR",
        "value": 100
    },
    "countryCode": "MY",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "John Doe",
        "shopperEmail": "[email protected]",
        "type": "tng"
    },
  "lineItems": [
    {
      "description": "订单描述"
    }
  ],
    "returnUrl": "https://wallet.futurepay-develop.com/api/PayNotify/paymentSynchronous/business_merchant_id/1/order_id/2115",
    "shopperReference": "FP3d9bcb7a0cf84b80bfc814e1cc43c613"
}

响应参数说明

参数名	类型	必填	说明
`code`	String	是	响应状态码，"0" 表示成功
`msg`	String	是	响应消息
`serverTime`	Number	是	服务器时间戳，单位毫秒
`data`	Object	是	业务数据对象
├── `action`	Object	是	支付跳转相关信息
│ ├── `paymentMethodType`	String	是	支付方式类型（如 alipaycn）
│ ├── `schemeUrl`	String	否	支付宝 scheme URL（用于 App 内支付）
│ ├── `applinkUrl`	String	否	支付宝 App 链接 URL（用于外部浏览器跳转）
│ ├── `payUrl`	String	是	FuturePay构建付款链接兼容APP/WAP/WEB
│ ├── `url`	String	是	Web 端支付 URL
│ ├── `qrCode`	String	否	付款二维码值（需将二维码值构建为二维码）
│ ├── `method`	String	是	请求方法（如 Get）
│ ├── `type`	String	是	操作类型（如 redirect）
├── `amount`	Object	是	订单金额信息
│ ├── `currency`	String	是	货币类型（如 HKD, USD）
│ ├── `value`	Number	是	金额数值，单位为最小货币单位
├── `merchantReference`	String	是	商户订单号
├── `pspReference`	String	是	支付平台交易号
├── `resultCode`	String	是	支付结果状态（如 PENDING）
`success`	Boolean	是	是否成功（true 表示成功）

交易调用输出

{
  "code": "0",
  "data": {
    "action": {
      "method": "Get",
      "paymentMethodType": "tng",
      "type": "redirect",
      "url": "https://psp.ac.alipay.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=281666040090bKjp7Py6m6HaaW2tUkxv3TLG&pspName=ALIPAY_HK&loadMode=2"
    },
    "amount": {
      "currency": "MYR",
      "value": 100
    },
    "merchantReference": "24112909553176-266",
    "pspReference": "1862435260155953152",
    "resultCode": "PENDING"
  },
  "msg": "success",
  "serverTime": 1732874163327,
  "success": true
}

附加信息

人民币处理须知

所有以人民币处理的交易均以美元或欧元结算。Alipay+对每笔交易采用一个外汇汇率，并以预定的结算货币（美元或欧元）向我们结算转换后的金额。我们也会与您结算转换后的金额。这意味着您必须跟踪每笔交易的外汇汇率，以便将其转换为结算货币（美元或欧元）。