UnionBank Online

支付方式属性

属性	值
可用国家代码	菲律宾（PH）
消费者货币	PHP
处理货币	PHP
结算货币	USD
类型 I	银行转账 (bankTransfer)
类型 II	`unionbankph`
会话超时	1小时
退款	不支持退款
集成类型	异步

交易流程

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

集成

请求参数说明

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（PHP）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（PH）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `telephoneNumber`	String	否	持卡人手机号
├── `type`	String	是	支付方式
├── `holderName`	String	否	持卡人姓名
├── `billingAddress`	String	否	付款人地址
`returnUrl`	String	是	支付完成后返回的 URL
`shopperReference`	String	是	付款人唯一标识

交易调用输入示例

{
    "amount": {
        "currency": "PHP",
        "value": 201
    },
    "paymentMethod":{
        "holderName":"test",
        "telephoneNumber":"123456456",
        "billingAddress":"Centro Avenida Doutor José S. Azevedo 142",
        "type":"unionbankph"
    },
    "productDetail": "test",
    "countryCode": "PH",
    "origin": "rrrrrr.com",
    "reference": "show17855224q114",
    "shopperReference": "show17855224q114",
    "returnUrl": "https://www.baidu.com/"
}

交易响应字段说明

参数名	类型	必填	说明
`code`	String	是	响应代码（如 0 表示成功）
`msg`	String	是	响应消息（如 success）
`serverTime`	Number	是	服务端时间戳（毫秒）
`success`	Boolean	是	请求是否成功
`data`	Object	是	响应数据主体
├── `action`	Object	是	支付动作信息
│ ├── `paymentMethodType`	String	是	支付方式类型
│ ├── `url`	String	是	跳转支付的 URL
│ ├── `method`	String	是	请求方式（如 GET/POST）
│ ├── `type`	String	是	动作类型（如 redirect 表示跳转支付）
├── `amount`	Object	是	订单金额信息
│ ├── `currency`	String	是	货币类型（PHP）
│ ├── `value`	Number	是	金额数值，单位为最小货币单位
├── `merchantReference`	String	是	商户侧订单号
├── `pspReference`	String	是	支付平台订单号（支付服务提供商生成的唯一标识）
├── `resultCode`	String	是	支付结果状态（如 PENDING 表示待支付）

交易调用输出示例

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