Omnipay API 测试 Demo

API 配置

所有接口使用 HTTP Basic Authentication。凭证由 Secrets 文档提供。

Username

Password

projectName

Environment Key (Spreedly)

3DS 类型

Base URL

Callback URL (可选, 禁止 localhost)

Initial 首次支付

前提: 必须先完成 Spreedly iFrame 集成并成功生成 payment_method。

Spreedly iFrame

Spreedly Environment Key

Environment

第一步: 点击"初始化 Spreedly"

持卡人信息 (表单采集, 传入 Spreedly tokenization)

First Name *

Last Name *

Email *

Expiry Month *

Expiry Year *

Country *

Address1 (实物必填)

City (实物必填)

State (实物必填)

Zip (实物必填)

Client IP (metadata.ip, 必填)

订单信息

Order ID *

Amount (分) *

Currency *

Shop URL

Product Type

Cart Item

Product ID

SKU

Product Name

browser_info (V1.8.0 起必填, 自动采集)

点击"采集 browser_info"自动填充

three_ds_authenticate_param (3DS 认证参数)

接入方必须先选定 Global 3DS 或 Merchant 3DS。此处组装 3DS 参数对象。

three_ds_type (TSO 测试用)

redirect_url

browser_info for 3DS (Base64, 自动从上方 browser_info 编码)

Payment Method 状态

状态: 未生成

等待请求...

3DS 认证处理

收到 AUTHENTICATE 响应后,按 threeDsType 类型处理。
Global 3DS: 启动 Spreedly ThreeDS.Lifecycle
Merchant 3DS: 弹窗加载 challengeUrl

AUTHENTICATE 响应数据

3DS Type (from response)

transactionToken

authenticateToken (Global 3DS)

challengeUrl (Merchant 3DS)

Status 轮询

轮询间隔 (ms)

最大轮询次数

等待 3DS 处理...

Status 交易状态查询

Order ID

Transaction Token

等待查询...

Upsell 追加销售

仅适用于非 MERCHANT_3DS 项目。必须存在已支付成功的 Initial 订单。

Order ID (新的)

Amount (分)

Payment Method Token

Currency

等待请求...

Refund 退款

Order ID

Refund Amount (分, 留空=全额)

Reason *

Event Time (Unix ms)

Note (可选)

等待请求...

Digital 数字产品接口

数字产品禁止传 shipping_* 字段,禁止调用 Shipped 接口。
MERCHANT_3DS 项目仅支持首笔 Digital Credit Purchase。

Digital Credit Purchase (首次)

Order ID

Amount (分)

Payment Method Token

Currency

等待请求...

Digital Token Purchase (后续扣款)

Order ID

Amount (分)

Payment Method Token

Currency

等待请求...

交易列表查询

需要管理员授权后才能访问。

排序

条数 (最大 50)

Since Transaction ID (游标)

等待查询...

Omnipay API 测试 Demo

API 配置

Initial 首次支付

3DS 认证处理

3DS 挑战页面

Status 交易状态查询

Upsell 追加销售

Refund 退款

Digital 数字产品接口

Digital Credit Purchase (首次)

Digital Token Purchase (后续扣款)

交易列表查询