Toss Pay

支付方式属性

属性	值
可用国家代码	KR
消费者货币	KRW
处理货币	KRW
结算货币	USD
类型 I	电子钱包（wallet）
类型 II	`tosspay`
最低交易金额	100 KRW
最高交易金额	绑定信用卡：客户信用额度绑定银行账户：2M KRW
会话超时时间	20 分钟
退款	全额，部分，多次
退款有效期	365 天
退款手续费	是
集成类型	异步

交易流程

在商家的结账页面，消费者选择使用 Toss Pay 支付。
PSP 向 Future Pay 发送交易请求，触发对 Toss Pay 的交易请求。
如果消费者通过桌面浏览器付款：
1. 消费者输入其在 Toss 注册的手机号码和出生日期。
2. 或者，消费者使用 Toss Pay 应用程序扫描支付页面上显示的二维码，并在 Toss Pay 应用程序中确认交易。
如果消费者通过移动设备付款：
1. 消费者会被重定向到其移动设备上的 Toss Pay 应用程序。
2. 消费者完成认证流程并在 Toss 移动应用程序中确认付款。

集成

交易调用输入

{
    "reference": "9B6F974D3DB8436AA2B139551933FF08",
    "amount": {
        "currency": "KRW",
        "value": 100
    },
    "countryCode": "KR",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "John Doe",
        "shopperEmail": "[email protected]",
        "type": "tosspay"
    },
    "returnUrl": "https://wallet.futurepay-develop.com/api/PayNotify/paymentSynchronous/business_merchant_id/1/order_id/2115",
    "shopperReference": "FP3d9bcb7a0cf84b80bfc814e1cc43c613"
}

交易调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1728633576429,
    "data": {
        "action": {
            "paymentMethodType": "tosspay",
            "url": "https://r2.girogate.de/molpay/S1389/I?tx=2334590813&rs=ZMQklSaGdmdZw9NTiM16xen8591YbjuY&cs=e1f62ec550918e3471308d9e34a830e3d7f22dc40690616190a9c16d8f653049",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "KRW",
            "value": 100
        },
        "merchantReference": "9B6F974D3DB8436AA2B139551933FF08",
        "pspReference": "1844649030089572352",
        "resultCode": "PENDING"
    },
    "success": true
}