QRPH

支付方式属性

属性	值
可用国家代码	菲律宾（PH）
消费者货币	PHP
处理货币	PHP
结算货币	USD
类型 I	电子钱包 (wallet)/银行转账 (bankTransfer)
类型 II	`qrph`
会话超时	30分钟
退款	不支持退款
集成类型	异步

交易流程

消费者在商家结账时选择使用 QRPH支付。
商户系统将付款请求转发给 Future Pay。
Future Pay向‌QRPH发起支付请求。
在QRPH响应后，Future Pay将响应转发给商户对应的二维码code字符串。
消费者确认付款后，QRPH通知支付成功结果到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	是	付款人唯一标识

交易调用输入示例

{
    "reference": "ljw1763369959745",
    "amount": {
        "currency": "PHP",
        "value": 1000
    },
    "productDetail": "ljwtest",
    "countryCode": "PH",
    "origin": "fffmall.com",
    "paymentMethod": {
        "type": "qrph",
        "billingAddress": "Centro Avenida Doutor José S. Azevedo 142",
        "holderName": "JW L",
        "telephoneNumber": "1506589656"
    },
    "returnUrl": "https://www.baidu.com/",
    "shopperReference": "LLL176094740252"
}

交易响应字段说明

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

交易调用输出示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1763370074132,
    "data": {
        "action": {
            "paymentMethodType": "qrph",
            "method": "Get",
            "type": "qrcode",
            "qrCode": "00020101021228800015ph.ppmi.p2micro0111OPDVPHM1XXX0315777148000000029041652948137246188600503001520460165303608540610.005802PH5908Yeecopay6015City Of Mandalu62350010ph.allbank0517C010579838215057488310012ph.ppmi.qrph0111OPDVPHM1XXX63046F01"
        },
        "amount": {
            "currency": "PHP",
            "value": 1000
        },
        "merchantReference": "ljw1763370072903",
        "pspReference": "1990344463200944128",
        "resultCode": "PENDING",
        "providerReference": "C0105758382150600"
    },
    "success": true
}