集成选项
收银台集成（Hosted Payment Page，HPP）和单一支付方式集成（Single Payment Method Integration） 是两种不同的支付集成方式，适用于不同的业务场景。
🌐 FuturePay 支付集成指南
一、收银台集成（Hosted Payment Page，HPP）
✅ 概述
收银台集成是 FuturePay 提供的托管支付页面服务。商户只需发起会话请求，即可使用统一支付页面，支持多种支付方式。
✅ 特点
- 集中管理：统一收银页面展示所有支付方式
- 多种支付方式：支持信用卡、电子钱包、银行转账等
- 高安全性：FuturePay 托管页面，符合 PCI DSS 标准
- 统一 UI/UX：无需商户开发支付界面
- 灵活集成：支持弹窗和嵌入两种方式
- 自适应布局：嵌入模式自动适配页面高度
📎 请求地址（HPP）
| 环境 | 新收银台地址 | 老收银台地址 |
|---|---|---|
| 沙盒环境 | POST https://api.futurepay-develop.com/checkout/newSession | POST https://api.futurepay-develop.com/checkout/session |
| 生产环境 | POST https://api.futurepay.global/checkout/newSession | POST https://api.futurepay.global/checkout/session |
💻 SDK 集成方式
安装 SDK
# 使用 npm/yarn/pnpm 安装
npm install @futurepay/checkout-sdk
yarn add @futurepay/checkout-sdk
pnpm add @futurepay/checkout-sdkUMD 引入（快速开始）
<script src="https://cdn.jsdelivr.net/npm/@futurepay/checkout-sdk@latest/dist/index.umd.min.js"></script>
<script>
const { openCheckoutModal, embedCheckout, PaymentCheckout } = window.FuturePayCheckoutSDK;
</script>ESM 引入（现代浏览器）
<script type="module">
import {
openCheckoutModal,
embedCheckout,
PaymentCheckout,
} from "https://cdn.jsdelivr.net/npm/@futurepay/checkout-sdk@latest/dist/index.esm.js";
</script>🛠️ SDK 使用示例
import { PaymentCheckout } from "@futurepay/checkout-sdk";
const checkout = new PaymentCheckout({
env: "test", // 或 "prod"
sessionToken: "your-session-token"
});
// 打开弹窗方式
await checkout.openModal();
// 或嵌入到指定容器
await checkout.embed("#container");✅ 适用场景
- 中小型企业、跨境电商平台
- 快速上线支付功能，降低合规风险
- 移动端友好、无需维护支付 UI
- 希望一站式集成多种支付方式的商户
二、单一支付方式集成（Single Payment Method Integration）
✅ 概述
商户通过调用 FuturePay API 接入某一种特定的支付方式，如信用卡、UPI、本地转账等。
📎 请求地址（单一支付）
| 环境 | 接口地址 |
|---|---|
| 沙盒环境 | POST https://api.futurepay-develop.com/payin/paymentOrder |
| 生产环境 | POST https://api.futurepay.global/payin/paymentOrder |
✅ 特点
- 完全自定义支付流程和 UI
- 仅支持一种支付方式
- 需自行处理合规和安全（如 PCI DSS）
- 适用于明确已知用户偏好支付方式的场景
✅ 适用场景
- 大型企业或有特殊需求的商户
- 定制化支付体验（前端 UI、流程等）
- 商户明确只支持某一支付方式
- 本地支付（如仅支持印度本地银行支付）
三、关键区别：收银台集成 vs 单一支付集成
| 对比项 | 收银台集成（HPP） | 单一支付方式集成 |
|---|---|---|
| 支持方式 | 多种支付方式一次集成 | 只支持一种支付方式 |
| 页面控制 | 页面由 FuturePay 托管 | 商户完全控制前端页面 |
| 安全性 | FuturePay 托管并负责合规 | 商户需处理合规和安全 |
| 集成复杂度 | 一次集成、低维护成本 | 每种支付方式需单独集成 |
| 适用对象 | 中小企业、跨境电商 | 大型平台、需自定义体验的商户 |
Updated 13 days ago