文档

All-In-One Checkout

Checkout API 提供了一种简单而灵活的方式来发起和授权在线支付。您可以使用相同的集成来通过卡（包括 3D Secure）、移动钱包和本地支付方式进行支付。

此 API 参考提供了有关可用端点及其交互方式的信息。

Suggest Edits

端点目标 URL

沙盒环境请求地址：POST https://api.futurepay-develop.com/checkout/session

生产环境请求地址：POST https://api.futurepay.global/checkout/session

字段说明

调用的特定输入参数

字段名称必填类型描述
amount.currencyMstring消费者为您的商品或服务支付款项时所使用的货
amount.valueMint消费者为您的商品或服务实际支付的金额
（ISO 4217 标准）以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。
countryCodeMstring消费者所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国）。系统会根据该国家代码自动调整并显示在该国可用的支付方式，以确保消费者能够使用适合其所在国家的支付方式完成交易
（ISO 3166-1 标准）
originMstring指订单来源，一般为网页地址（URL）
referenceMstring由您的系统生成并分配给每笔订单的唯一标识符，用于再系统中追踪订单
returnUrlMstring指消费者在支付成功后，系统自动将消费者重定向到的网页地址（URL），此URL通常用于显示支付成功的确认页面，或将消费者带回到商户网站的指定页面
productDetailOstring购买产品详情/订单描述(如为Alipay+支付方式则该参数为必传)
productNameOstring购买产品名称/标题
paymentMethod.typeOstring支付方式（设置此值后，收银台将优先选择传入的支付方式作为默认付款方式）
paymentMethod.shopperEmailOstring消费者邮箱地址
paymentMethod.firstNameOstring消费者名字
paymentMethod.lastNameOstring消费者姓氏

调用的特定响应参数

字段名必填类型说明示例值
msgMString响应信息，表示请求的处理结果。success
codeMString响应码，表示请求的处理状态，0 表示成功。更多code返回请参考该地址0
dataMObject响应数据对象，包含具体的返回内容。{ "checkOutUrl": "https://checkout.futurepay-develop.com/checkout/createOrder?token=..."}
└─ checkOutUrlMString收银台跳转 URL，用于用户跳转到支付页面。https://checkout.futurepay-develop.com/checkout/createOrder?token=44f0dce6-c49c-4cb6-9d17-3a86359d58e7
successMBoolean请求是否成功的标识。true
serverTimeMLong服务器响应时间，Unix 时间戳（毫秒）。1727586009474

集成

交易调用输入

{
    "amount": {
        "currency": "USD",
        "value": 100
    },
    "paymentMethod": {
        "type": "alipay",
        "firstName": "ming",
        "lastName": "xing",
      "shopperEmail":"[email protected]"
    },
    "productDetail": "购买产品详情/订单描述",
    "countryCode": "US",
    "origin": "fffmall.com",
    "reference": "24092905000017-564",
    "returnUrl": "https://wallet.futurepay-develop.com/api/PayNotify/paymentSynchronous/business_merchant_id/1/order_id/2083"
}

交易调用输出

{
    "msg": "success",
    "code": "0",
    "data": {
        "checkOutUrl": "https://checkout.futurepay-develop.com/checkout/createOrder?token=44f0dce6-c49c-4cb6-9d17-3a86359d58e7"
    },
    "success": true,
    "serverTime": 1727586009474
}

WEBHOOK

{
    "appId": "1802583469172330496",
    "merchantId": "1802557498776006656",
    "notificationItems": [
        {
            "amount": {
                "currency": "USD",
                "value": 100
            },
            "eventCode": "TRANSACTION",
            "eventDate": 1727603276000,
            "merchantReference": "24092905000017-564",
            "paymentMethod": "skrill",
            "pspReference": "1840327561662562304",
            "resultCode": "SUCCEED"
        }
    ]
}

📘

请通过您的商户系统查看已激活的支付方式，以了解可用的支付选项。

Updated 18 days ago