BLIK One Click

支付方式属性

属性	值
适用国家代码	PL（波兰）
消费者货币	波兰兹罗提 (PLN)
处理货币	波兰兹罗提 (PLN)
结算货币	波兰兹罗提 (PLN)
类型 I	银行转帐 (bankTransfer)
类型 II	`blikst`
最低交易金额	PLN 2
最高交易金额	PLN 50,000/每笔交易（大多数发卡机构的限额为 PLN 10,000/每笔交易）
会话超时	55秒
退款	支持全额、部分和多次部分退款
退款有效期	13个月
拒付	是
集成类型	异步

交易流程

消费者选择使用 BLIK One Click 付款。
消费者在其移动设备上启动银行应用程序，并输入应用程序中的六位数BLIK支付代码。该代码有效期为两分钟。
商家向 Future Pay 发送交易请求。
系统根据 BLIK 码验证消费者身份。如果验证成功，会向包含该 BLIK码的手机银行应用程序
发送推送通知，并唤醒应用。
手机银行应用向消费者显示交易信息，并等待其确认。
如果授权成功，银行应用将显示交易成功通知。
消费者被重定向回商家网站，并在商家页面上看到交易成功消息。

集成

交易调用输入

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

{
    "reference": "TR1739188526ANM7D7",
    "amount": {
        "currency": "PLN",
        "value": 10000
    },
    "productDetail": "描述订单",
    "countryCode": "PL",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "test",
        "shopperEmail": "[email protected]",
        "type": "blikst",
        "authCode": "123456"
    },
    "returnUrl": "https://www.baidu.com",
    "browserInfo": {
        "osType": "IOS",
        "terminalType": "APP"
    },
    "billingAddress": {
        "city": "San Francisco",
        "country": "US",
        "street": "1234 Market Street, Suite 500",
        "postalCode": "94103",
        "stateOrProvince": "California"
    },
    "shopperReference": "8cc77a71707447819ef87155926516cc"
}

交易调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1785226697940,
    "data": {
        "action": {
            "paymentMethodType": "blikst",
            "method": "Get",
            "type": "authorize"
        },
        "amount": {
            "currency": "PLN",
            "value": 10000
        },
        "merchantReference": "TR1739188526ANM7D7",
        "pspReference": "2082017786346995712",
        "resultCode": "PENDING",
    },
    "success": true
}

失败场景说明

输入指定的邮箱，Future Pay判断用户邮箱返回对应的错误信息。

➥ 场景 A：立即失败 (Immediate Failures)。一调用接口，立刻就会返回失败。

模拟输入的 BLIK 验证码格式无效：.invalid_code@.
- 例如：[email protected]
模拟用户输入的 6 位验证码已过期（超过了 2 分钟）：.expired_code@.

➥ 场景 B：银行拒绝 —— 8 秒延迟 (Declines) 后，触发支付失败的 Webhook。

模拟用户在手机 App 里收到了弹窗，但手动点击了“拒绝”：.customer_declined@.
模拟用户银行卡余额不足：.insufficient_funds@.
模拟超出了该银行账户的支付限额：.limit_exceeded@.
模拟银行或 BLIK 网络因未知原因拒绝：.bank_declined@.

➥ 场景 C：超时 —— 60 秒延迟 (Timeouts) 后，触发超时的 Webhook。

模拟用户在收银台提交了验证码，但死活不打开手机银行 App 确认，经过 60 秒后自然超时：.customer_timeout@.
模拟请求用户银行时网络超时：.bank_timeout@.