---
updatedAt: 2026-08-10T09:05:38.000Z
agentTools:
  projectIndex: https://doc.futurepay.global/llms.txt
---

# MobilePay

MobilePay 是一种在丹麦和芬兰使用的单次使用型卡片支付方式。用户可以通过 MobilePay 应用程序进行支付验证和审批操作。

# 支付方式属性

| 属性     | 值               |
| ------ | --------------- |
| 适用国家代码 | 丹麦（DK）、芬兰（FI）   |
| 消费者货币  | DKK、EUR、NOK、SEK |
| 处理货币   | DKK、EUR、NOK、SEK |
| 类型 I   | 钱包 (wallet)     |
| 类型 II  | `mobilepay`     |
| 会话超时   | 取决于流程           |
| 退款     | 支持全额、部分和多次部分退款  |
| 拒付     | 是               |
| 集成类型   | 异步              |

# 交易流程

* 移动端<br />1.消费者在商家的结账页面选择 MobilePay。<br />2.Future Pay 发起 MobilePay 支付请求。<br />3.用户浏览器或 App 跳转至 MobilePay App。<br />4.用户在 MobilePay App 中查看并确认付款。<br />5.MobilePay 使用消费者绑定的银行卡完成支付。<br />6.支付完成后，消费者返回商户网站或 App。<br />7.将支付成功或失败结果通知 Future Pay。<br />8.Future Pay 更新订单状态，并向商户发送交易结果通知。<br />9.消费者在商户页面查看最终支付结果。
* PC / Desktop

  1.消费者在商家结账页面选择 MobilePay。<br />2.Future Pay 发起支付请求。<br />3.消费者输入绑定 MobilePay 的手机号码。<br />4.MobilePay 向消费者手机 App 发送 Push 通知。<br />5.消费者打开 MobilePay App 并确认支付。<br />6.处理消费者绑定银行卡的交易。<br />7.将支付结果通知 Future Pay。<br />8.Future Pay 更新订单状态，并向商户发送交易结果通知。<br />9.商户向消费者展示最终支付结果。

## 请求参数说明

| 参数名                   | 类型     | 必填 | 说明                                        |
| --------------------- | ------ | -- | ----------------------------------------- |
| `reference`           | String | 是  | 订单唯一标识                                    |
| `amount`              | Object | 是  | 订单金额信息                                    |
| ├── `currency`        | String | 是  | 货币类型（如 USD，CAD）                           |
| ├── `value`           | Number | 是  | 金额数值，单位为最小货币单位                            |
| `productDetail`       | String | 是  | 订单描述                                      |
| `countryCode`         | String | 是  | 国家代码（如 US）                                |
| `origin`              | String | 是  | 订单来源，如商城域名                                |
| `paymentMethod`       | Object | 是  | 支付方式信息                                    |
| ├── `holderName`      | String | 否  | 付款人姓名                                     |
| ├── `shopperEmail`    | String | 否  | 付款人邮箱                                     |
| ├── `type`            | String | 是  | 支付方式（如 mobilepay）                         |
| `returnUrl`           | String | 是  | 支付完成后返回的 URL                              |
| `browserInfo`         | Object | 否  | 设备浏览器信息（如不指定该信息，则会获取userAgent信息判断消费者终端信息） |
| ├── `osType`          | String | 否  | 操作系统类型（如 IOS, ANDROID,OTHER）              |
| ├── `terminalType`    | String | 否  | 终端类型（如 APP, WAP,WEB,MINI\_APP）            |
| `shopperReference`    | String | 是  | 付款人唯一标识                                   |
| `webhookUrl`          | String | 否  | 回调通知地址                                    |
| `billingAddress`      | Object | 否  | 账单地址                                      |
| ├── `city`            | String | 否  | 城市                                        |
| ├── `country`         | String | 否  | 国家                                        |
| ├── `street`          | String | 否  | 街道                                        |
| ├── `postalCode`      | String | 否  | 邮编                                        |
| ├── `stateOrProvince` | String | 否  | 州/省                                       |

## 交易调用输入示例

```json
{
    "reference": "TR1739188526ANM7D7",
    "amount": {
        "currency": "EUR",
        "value": 5100
    },
    "productDetail": "描述订单",
    "countryCode": "DK",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "test",
        "shopperEmail": "test@gmail.com",
        "type": "mobilepay"
    },
    "returnUrl": "https://www.baidu.com",
    "billingAddress": {
        "city": "San Francisco",
        "country": "US",
        "street": "1234 Market Street, Suite 500",
        "postalCode": "94103",
        "stateOrProvince": "California"
    },
    "shopperReference": "8cc77a71707447819ef87155926516cc"
}
```

## 响应参数说明

| 参数名                       | 类型      | 必填 | 说明                    |
| ------------------------- | ------- | -- | --------------------- |
| `code`                    | String  | 是  | 响应状态码，"0" 表示成功        |
| `msg`                     | String  | 是  | 响应消息                  |
| `serverTime`              | Number  | 是  | 服务器时间戳，单位毫秒           |
| `data`                    | Object  | 是  | 业务数据对象                |
| ├── `action`              | Object  | 是  | 支付跳转相关信息              |
| │ ├── `paymentMethodType` | String  | 是  | 支付方式类型（如 `mobilepay`） |
| │ ├── `url`               | String  | 是  | Web 端支付 URL           |
| │ ├── `method`            | String  | 是  | 请求方法（如 Get）           |
| │ ├── `type`              | String  | 是  | 操作类型（如 redirect）      |
| ├── `amount`              | Object  | 是  | 订单金额信息                |
| │ ├── `currency`          | String  | 是  | 货币类型（如 USD）           |
| │ ├── `value`             | Number  | 是  | 金额数值，单位为最小货币单位        |
| ├── `merchantReference`   | String  | 是  | 商户订单号                 |
| ├── `pspReference`        | String  | 是  | 支付平台交易号               |
| ├── `resultCode`          | String  | 是  | 支付结果状态（如 PENDING）     |
| `success`                 | Boolean | 是  | 是否成功（true 表示成功）       |

## 交易调用输出示例

```json
{
    "code": "0",
    "msg": "success",
    "serverTime": 1783594292375,
    "data": {
        "action": {
            "paymentMethodType": "mobilepay",
            "url": "https://r2.girogate.de/molpay/S1389/I?tx=2334590813&rs=ZMQklSaGdmdZw9NTiM16xen8591YbjuY&cs=e1f62ec550918e3471308d9e34a830e3d7f22dc40690616190a9c16d8f653049",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "EUR",
            "value": 5100
        },
        "merchantReference": "TR1739188526ANM7D7",
        "pspReference": "2075170980153655296",
        "resultCode": "PENDING"
    },
    "success": true
}
```