SPEI

支付方式属性

字段名称	内容
可用国家代码	墨西哥 (MX)
消费者货币	墨西哥比索 (MXN)
处理货币	墨西哥比索 (MXN)
结算货币	美元 (USD)
类型 I	银行转账 (bankTransfer)
类型 II	`speico`
最大交易金额	190000 MXN
会话超时	360分钟
退款	支持退款
拒付	无
集成类型	异步

交易流程

消费者在商家的结账页面选择SPEI付款。
消费者被重定向到 Future Pay 托管的银行支付信息页面。
消费者根据银行支付信息页完成支付。
消费者完成交易。
消费者被重定向对应页面。

集成

请求参数说明：

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 MXN）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 MX）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `shopperEmail`	String	是	付款人邮箱
├── `type`	String	是	支付方式（如 speico）
├── `telephoneNumber`	String	否	电话号码
`returnUrl`	String	是	支付完成后返回的 URL
`shopperReference`	String	是	付款人唯一标识

交易调用输入示例

{
    "reference": "TR1739188526ANM7D5",
    "amount": {
        "currency": "MXN",
        "value": 4500
    },
    "productDetail": "描述订单",
    "countryCode": "MX",
    "origin": "fffmall.com",
    "paymentMethod": {
        "shopperEmail": "[email protected]",
         "type": "speico",
				 "telephoneNumber":"555555555"
    },
    "returnUrl": "https://www.baidu.com",
    "shopperReference": "8cc77a71707447819ef87155926516cc"
}

响应参数说明

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

交易调用输出示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1739257937234,
    "data": {
        "action": {
            "paymentMethodType": "speico",
            "url": "https://psp.ac.alipay.com/page/simulation-wallet/acwallet/alipayconnectcode.html?code=2816660400949Sy36H8Dh0ch7H6GlNKv4Io2&pspName=ALIPAY_HK&loadMode=2&needPull=false",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "MX",
            "value": 4500
        },
        "merchantReference": "TR1739188526ANM7D5",
        "pspReference": "1889210827400151040",
        "resultCode": "PENDING"
    },
    "success": true
}

附加信息

speico 类型支付说明

当 type = speico 时，系统为订单生成的 虚拟账户（VA） 支持 多次付款。
因此在实际使用过程中，可能会出现以下两种处理场景：

场景一：金额不一致自动退款（默认策略）

当付款金额 与拉单金额不一致 时：

当前付款交易会 判定为失败
系统会自动触发 退款流程
后续再次向该 VA 账户转账 时，系统会 自动退款

该策略适用于 严格金额匹配的支付场景。

场景二：生成新的收单交易（可选策略）

当付款金额 与拉单金额不一致 时：

系统会 自动生成一笔新的收单交易
新生成交易的 商户订单号仍为拉单时传入的商户订单号
新交易将按照 实际付款金额进行处理并状态为交易成功

该策略需要 联系客服开启。

说明

同一 VA 账户 在 speico 模式下 允许多次付款
不同处理逻辑由 系统策略配置决定
如需开启 金额不一致自动生成新订单模式，请联系平台客服