Cash App

支付方式属性

字段名称	内容
可用国家代码	美国(US)
消费者货币	USD
处理货币	USD
结算货币	美元 (USD)
类型 I	电子钱包(wallet)
类型 II	`cashapp`
退款	支持退款
拒付	有
集成类型	异步

交易流程

消费者在商家结账页选择 Cash App 作为支付方式。
商家后台根据消费者的客户端类型返回对应的支付指引：
- WAP：返回跳转链接，引导用户前往 Cash App 完成支付；
- Web / PC：返回二维码，供消费者使用 Cash App 扫码支付。
消费者在 Cash App 中完成支付。
支付完成后，消费者被重定向回商家指定的结果页面。

集成

请求参数说明：

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 USD）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 US）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `shopperEmail`	String	否	付款人邮箱
├── `type`	String	是	支付方式（如 cashapp）
├── `holderName`	String	否	姓名
`browserInfo`	String	否	浏览器信息
├── `terminalType`	String	否	浏览器类型（WAP/WEB/PC）
`returnUrl`	String	是	支付完成后返回的 URL
`shopperReference`	String	是	付款人唯一标识

交易调用输入示例

{
    "amount": {
        "currency": "USD",
        "value": 1000
    },
    "countryCode": "US",
    "origin": "fffmall.com",
    "paymentMethod": {
        "shopperEmail": "[email protected]",
        "holderName": "JW L",
        "type": "cashapp"
       
    },
    browserInfo:{
        terminalType: "WAP"
    },
    "productDetail": "ljwtest",
    "productName": "WEWQ",
    "reference": "ljw1769658309659",
    "returnUrl": "https://www.baidu.com/",
    "shopperReference": "LLL3211321",
    "webhookUrl": "https://develop.futureshop.global/api/checkout/payment/123"
}

响应参数说明

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

交易调用输出示例

WEB:

{
    "code": "0",
    "msg": "success",
    "serverTime": 1770627304189,
    "data": {
        "action": {
            "paymentMethodType": "cashapp",
            "url": "https://pm-redirects.stripe.com/authorize/acct_1RgMuM08pryDCbBW/pa_nonce_TwjiN9uiYurcrlxvVoR6sI88PPyKcUx",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "USD",
            "value": 1000
        },
        "merchantReference": "ljw1770627300088",
        "pspReference": "2020783486851481600",
        "resultCode": "PENDING",
        "providerReference": "pi_3SyqFG08pryDCbBW0FkSj95k"
    },
    "success": true
}

QR:

{
    "code": "0",
    "msg": "success",
    "serverTime": 1770627763354,
    "data": {
        "action": {
            "paymentMethodType": "cashapp",
            "url": "https://qr.stripe.com/test_YWNjdF8xUmdNdU0wOHByeURDYkJXLF9Ud2pxOWRZcFNMbGpJRjUyUHJjWmpaaEZOVTB3U29H0100515OQHI7.png",
            "method": "Get",
            "type": "qrcode",
            "qrCode": "https://qr.stripe.com/test_YWNjdF8xUmdNdU0wOHByeURDYkJXLF9Ud2pxOWRZcFNMbGpJRjUyUHJjWmpaaEZOVTB3U29H0100515OQHI7.png"
        },
        "additionalData": {
            "expireTime": "1770627783",
            "qrType": "img"
        },
        "amount": {
            "currency": "USD",
            "value": 1000
        },
        "merchantReference": "ljw1770627759140",
        "pspReference": "2020785412406116352",
        "resultCode": "PENDING",
        "providerReference": "pi_3SyqMf08pryDCbBW0DV6oU8Z"
    },
    "success": true
}

附加信息

无