FPX

属性	值
可用国家代码	MY
消费者货币	MYR
处理货币	MYR
结算货币	USD
类型 I	银行转账 (bankTransfer)
类型 II	`fpx`
最低交易金额	Retail Banking类型的银行最低金额为1.00 MYR
最高交易金额	Retail Banking类型的银行最高金额为30000.00 MYR
会话超时	10分钟
退款	不支持退款
集成类型	异步

交易流程

消费者在商家的结账页面选择FPX Online Banking选项。
消费者被重定向到 Future Pay 托管的银行选择页面。
消费者选择银行完成支付。
消费者被重定向到网上银行页面，在那里他们进行身份验证以完成支付。
消费者完成交易。
消费者被重定向对应页面。

集成

交易调用的额外输入

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 HKD, USD）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述如"TEST"，值必须是字母或数字,超过30位字符会进行截取。
`countryCode`	String	是	国家代码（如 TH, CN）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `shopperEmail`	String	是	付款人邮箱
├── `telephoneNumber`	String	是	付款人手机号
├── `bankName`	String	是	如:"ABB0233-B2C" (UAT测试环境传入"TEST0021-B2C"或"TEST0021-B2B1")
├── `type`	String	是	支付方式（如 naverpay）
`returnUrl`	String	是	支付完成后返回的 URL
`shopperReference`	String	是	付款人唯一标识

字段名称	类型	必填	示例值	可选值
bankName	String	M	如:"ABB0233-B2C" (UAT测试环境传入"TEST0021-B2C"或"TEST0021-B2B1")	银行代码 (bankName) 详细列表见下方表格
productDetail	String	M	如"TEST"，值必须是字母或数字,超过30位字符会进行截取。

银行名称 (bankNameDesc)	银行代码 (bankName)
Affin Bank (Retail Banking)	ABB0233-B2C
Alliance Bank (Personal) (Retail Banking)	ABMB0212-B2C
AmBank (Retail Banking)	AMBB0209-B2C
Bank Islam (Retail Banking)	BIMB0340-B2C
Bank Rakyat (Retail Banking)	BKRM0602-B2C
Bank Muamalat (Retail Banking)	BMMB0341-B2C
Agrobank (Retail Banking)	AGRO01-B2C
BSN (Retail Banking)	BSN0601-B2C
BOC (Retail Banking)	BOCM01-B2C
CIMB Clicks (Retail Banking)	BCBB0235-B2C
HSBC Bank (Retail Banking)	HSBC0223-B2C
Hong Leong Bank (Retail Banking)	HLB0224-B2C
KFH (Retail Banking)	KFH0346-B2C
Maybank2E (Retail Banking)	MBB0228-B2C
Maybank2U (Retail Banking)	MB2U0227-B2C
OCBC Bank (Retail Banking)	OCBC0229-B2C
Public Bank (Retail Banking)	PBB0233-B2C
RHB Bank (Retail Banking)	RHB0218-B2C
Standard Chartered (Retail Banking)	SCB0216-B2C
UOB Bank (Retail Banking)	UOB0226-B2C

交易调用输入

{
    "reference": "9B6F974D3DB8436AA2B139551933FF08",
    "amount": {
        "currency": "MYR",
        "value": 100
    },
    "countryCode": "MY",
    "origin": "fffmall.com",
    "paymentMethod":{
        "bankName":"TEST0021-B2C",
        "shopperEmail":"[email protected]",
        "telephoneNumber":"603-21414552",
        "type":"fpx"
    },
		"productDetail": "test",
    "returnUrl": "https://wallet.futurepay-develop.com/api/PayNotify/paymentSynchronous/business_merchant_id/1/order_id/2115",
    "shopperReference": "FP3d9bcb7a0cf84b80bfc814e1cc43c613"
}

交易调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1728633576429,
    "data": {
        "action": {
          "paymentMethodType": "fpx",
          "url": "https://r2.girogate.de/molpay/S1389/I?tx=2334590813&rs=ZMQklSaGdmdZw9NTiM16xen8591YbjuY&cs=e1f62ec550918e3471308d9e34a830e3d7f22dc40690616190a9c16d8f653049",
          "method": "Get",
          "type": "redirect"
        },
        "amount": {
            "currency": "MYR",
            "value": 100
        },
        "merchantReference": "9B6F974D3DB8436AA2B139551933FF08",
        "pspReference": "1844649030089572352",
        "resultCode": "PENDING"
    },
    "success": true
}