开发者资源

构建可验证的付款流程。

创建一笔订单,展示 ON_SITE 结账或跳转 HPP,履约前在服务器查询付款。

REST API · 结账展示

同一付款订单,选择 ON_SITE 或 HPP。

在服务器创建订单并保存本地绑定,再选择客户付款界面,两种模式使用同一 order_id。

ON_SITE

结账中的付款对话框

在自己的域名用对话框展示精确数量、地址、网络和二维码,由后端查询并返回安全付款信息。

查看内嵌 HTML + PHP →
HPP

跳转到 MochiPay 结账

服务器将客户跳转至 payment_url;付款后通过认证的订单查询验证返回或通知。

查看 PHP 跳转示例 →

以下摘录来自 PHP Demo 1.1.1(PHP 7.0–8.4)的 checkout.php 及辅助文件。先通过 order.php 创建订单,结果提供两种示例链接。生产商城应从会话/数据库解析获授权本地订单,并通过幂等事务完成履约。

HPP · PHP

服务器验证后跳转

验证已保存的订单绑定与目标地址,再在任何页面输出前发送 Location 响应头。

checkout.php · HPP 分支
// checkout.php: after loading the saved attempt and
// verifying its token, order binding and payment URL.
// $payment is the authenticated Query Order response.
if ($mode === 'HPP') {
    header('Location: ' . $payment['payment_url'], true, 303);
    exit; // Send the header before any HTML output.
}
// Verify the notification/return server-side before fulfillment.

完整文件在进入此分支前加载已保存尝试,验证令牌、认证查询及预期 payment_url。

ON_SITE · PHP + HTML

将对话框嵌入自己的页面

在结账 HTML 引入本地对话框资源,浏览器只与本地轮询接口通信,不签名,也不接收 API 凭证。

checkout.php · 本地对话框资源
// checkout.php: use the SAME saved reference/token.
$pollUrl = 'order.php?' . http_build_query([
    'view' => $reference, 'token' => $token, 'poll' => 1
], '', '&', PHP_QUERY_RFC3986);
$completeUrl = 'callback.php?' . http_build_query([
    'mode' => 'return', 'merchant_order_id' => $reference
], '', '&', PHP_QUERY_RFC3986);
$config = json_encode([
    'poll' => $pollUrl, 'complete' => $completeUrl
], JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT);
?>
<!-- Inside your own checkout page: -->
<link rel="stylesheet" href="portable/onsite.css">
<button id="reopen" type="button">Open payment dialog</button>
<script>window.MochiPayConfig = <?php echo $config; ?>;</script>
<script src="portable/qrcode.min.js"></script>
<script src="portable/onsite.js"></script>

onsite.js 在现有页面上打开对话框,关闭后仍保留结账页;重新打开按钮复用同一付款。

由你的后端验证订单

验证已保存的编号/令牌权限,通过保存的 MochiPay order_id 查询并核对原始金额/币种、资产/网络、地址和准确应付金额。仅返回以十进制字符串表示的安全支付信息。

order.php · 本地轮询接口
// order.php?view=...&token=...&poll=1 (server-side)
// The demo has already authorized the saved attempt/token.
$response = mochipay_query_order(
    'order_id', $record['snapshot']['order_id']
);
if (!$response['ok'] || !mochipay_bound($record, $response['data'])) {
    http_response_code(403);
    exit;
}
// Also check the expected received amount before accepting PAID.
header('Content-Type: application/json; charset=utf-8');
header('Cache-Control: no-store');
echo json_encode([
    'success' => true,
    'data' => MochiPayPortable::view($response['data'])
]); // Safe view: decimal strings; no credentials/customer fields.

完整演示还会核对 PAID 状态下的实收金额,callback.php 会验证通知和浏览器返回。截图、跳转或浏览器标记均不能证明付款。

01

身份验证

每次 API 请求均需商户 API Key 和 Base64 编码的 HMAC-SHA256 签名。

请求头必填说明
X-Mochi-Key是你的商户 API Key。
X-Mochi-Signature是Base64 编码的 HMAC-SHA256 签名。
Content-TypePOST 请求application/json
API Secret 保留在服务器。 绝不能在浏览器 JavaScript、移动应用或公开源码中暴露它。

签名

创建订单时,对原始 JSON 请求正文签名;查询订单时,对去掉开头符号的原始查询字符串签名 ?.

签名公式
Base64(HMAC-SHA256(UTF8(signing_text), UTF8(api_secret)))
02

支持的币种

订单币种用于购买定价,支付方式决定付款使用的加密货币与区块链网络。

订单币种

支持 28 种法币

在以下参数中使用这些准确的 ISO 代码之一: currency 字段。

USDEURGBPCAD AUDNZDJPYCNY HKDSGDCHFSEK NOKDKKPLNCZK HUFAEDSARINR IDRTHBMYRPHP KRWBRLMXNZAR
加密货币订单币种

加密货币定价

订单也可以直接使用这些加密货币定价。

USDTUSDCBTCETHSOL
支付方式

支持的加密货币与网络组合

在以下参数中填写这些准确值之一: payment_method 字段。

USDT_TRC20USDT on TRON
USDC_ERC20USDC on Ethereum
BTC_BITCOINBitcoin 网络原生 BTC
ETH_ERC20Ethereum 网络原生 ETH
SOL_SOLANASolana 网络原生 SOL
换算规则: 订单币种与支付资产相同时,MochiPay 使用汇率 1 ,无需换算;其他情况在创建订单时应用保存的汇率及商户加价。 查看当前参考汇率 →
订单金额支付方式结果
49.90 USDUSDT_TRC20使用已保存的 USD → USDT 汇率和商户加价。
100 EURBTC_BITCOIN使用已保存的 EUR → BTC 汇率和商户加价。
25 USDCUSDC_ERC20无需换算,汇率为 1.
03

创建订单

创建付款订单,获取托管付款 URL 以及站内界面所需的付款说明。

POST https://mochi.bz/api/v1/orders/create

请求参数

订单币种与支付方式是不同概念。 amount 及 currency 定义商户的原始订单金额。 payment_method 定义顾客支付使用的加密货币及区块链网络。例如, 49.90 USD 使用 USDT_TRC20 表示以 USD 计价的订单,使用计算出的 USDT 数量在 TRON 网络付款。
参数必填类型 / 长度说明
merchant_order_id是string · 1–100商户订单号。不传 request_id 时,每次成功开单都会生成新的全局唯一 MochiPay order_id。传入 request_id 时,重试会复用原订单。
amount是decimal(28,8)原始订单金额须为正数;法币通常使用 2 位小数,支持的加密货币最多可用 8 位。
currency是string · 1–20原始订单币种代码,可以是法币,例如 USD 或 EUR,也可以是加密货币,例如 USDT 或 USDC.
payment_method是资产代码 ≤20 + 网络代码 ≤30支付使用的加密货币及区块链网络,对应 ASSET_NETWORK 格式,例如 USDT_TRC20 或 USDC_ERC20.
unique_amount_direction否UP 或 DOWN唯一金额微调方向,默认为 UP.
product_type否PHYSICAL 或 DIGITAL_SERVICE结账页展示的订单类型,默认为 DIGITAL_SERVICE。两种类型的配送字段均为可选。
description否string · 0–500易于阅读的订单说明。
product_info否JSON/string · nvarchar(max)商品、购物车或自定义元数据,完整 HTTP 请求体不得超过 65,536 字节。
customer_email否string · 0–255客户邮箱;若提供,必须为有效邮箱地址。
customer_phone否string · 0–50客户电话号码。
first_name否string · 0–100客户名字。
last_name否string · 0–100客户姓氏。
company否string · 0–200客户公司或组织名称。
country否string · 0–100客户所在国家或地区。
state否string · 0–100客户所在州、省或地区。
city否string · 0–100客户所在城市。
address1否string · 0–500客户主要收货地址。
address2否string · 0–500客户附加地址信息。
postal_code否string · 0–30客户邮政编码。
request_id否string · 1–64可选重试请求号,仅作用于当前商户,并随 JSON 正文签名。超时后复用相同请求号及内容。参见 请求去重.
notify_url否string · 0–1000绝对值 http:// 或 https:// 异步通知地址。仅允许公网接收端,拦截 localhost、内网或保留地址及重定向。
redirect_url否string · 0–1000付款成功后使用的完整客户返回 URL。
customer_ip否IPv4/IPv6 · 0–45商户提供的客户 IP;MochiPay 另行记录 API 请求 IP。

请求示例

JSON
{
  "merchant_order_id": "ORDER-20260919-001",
  "amount": 49.90,
  "currency": "USD",
  "payment_method": "USDT_TRC20",
  "unique_amount_direction": "UP",
  "product_type": "DIGITAL_SERVICE",
  "description": "MochiPay order",
  "customer_email": "customer@example.com",
  "redirect_url": "https://merchant.example.com/payment/return"
}
C# · 创建订单
string baseUrl = "https://mochi.bz";
string body = @"{
  ""merchant_order_id"": ""ORDER-20260920-001"",
  ""amount"": 49.90,
  ""currency"": ""USD"",
  ""payment_method"": ""USDT_TRC20"",
  ""unique_amount_direction"": ""UP"",
  ""product_type"": ""DIGITAL_SERVICE"",
  ""description"": ""Example order"",
  ""notify_url"": ""https://merchant.example.com/mochipay/notify"",
  ""redirect_url"": ""https://merchant.example.com/payment/return""
}";

string signature;
using (var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret)))
{
    signature = Convert.ToBase64String(
        hmac.ComputeHash(Encoding.UTF8.GetBytes(body)));
}

using (var client = new HttpClient())
using (var request = new HttpRequestMessage(
    HttpMethod.Post, baseUrl + "/api/v1/orders/create"))
{
    request.Headers.Add("X-Mochi-Key", apiKey);
    request.Headers.Add("X-Mochi-Signature", signature);
    request.Content = new StringContent(body, Encoding.UTF8, "application/json");
    HttpResponseMessage response = await client.SendAsync(request);
    string json = await response.Content.ReadAsStringAsync();
}
PHP 7.0–8.4 · 创建订单
<?php
$baseUrl = 'https://mochi.bz';
$apiKey = 'YOUR_API_KEY';
$apiSecret = 'YOUR_API_SECRET';

$payload = [
    'merchant_order_id' => 'ORDER-20260920-001',
    'amount' => '49.90',
    'currency' => 'USD',
    'payment_method' => 'USDT_TRC20',
    'unique_amount_direction' => 'UP',
    'product_type' => 'DIGITAL_SERVICE',
    'description' => 'Example order',
    'notify_url' => 'https://merchant.example.com/mochipay/notify',
    'redirect_url' => 'https://merchant.example.com/payment/return'
];

$body = json_encode($payload, JSON_UNESCAPED_SLASHES);
$signature = base64_encode(
    hash_hmac('sha256', $body, $apiSecret, true)
);

$ch = curl_init($baseUrl . '/api/v1/orders/create');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-Mochi-Key: ' . $apiKey,
        'X-Mochi-Signature: ' . $signature
    ],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_TIMEOUT => 30
]);

$json = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($json === false) {
    throw new RuntimeException($error);
}

// Preserve decimal JSON numbers as text before decoding.
$json = preg_replace(
    '/("(?:amount|base_pay_amount|pay_amount|received_amount|exchange_rate|rate_markup_percent|unique_amount_delta)"\s*:\s*)(-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?)(?=\s*[,}])/',
    '$1"$2"', $json
);
$result = json_decode($json, true);
if ($httpCode < 200 || $httpCode >= 300 || empty($result['success'])) {
    throw new RuntimeException('MochiPay request failed. Review before retrying creation.');
}
?>

成功响应

字段类型 / 长度说明
successboolean创建成功时为 true。
order_idstring · 32MochiPay 系统标识,请与本地订单一同保存。
merchant_order_idstring · ≤100你的原始商户订单编号。
product_typestring · ≤20PHYSICAL 或 DIGITAL_SERVICE。
statusstring · ≤20当前付款状态。
amountdecimal(28,8)原始订单金额;必须保留小数精度。
currencystring · ≤20原始定价币种。
base_pay_amountdecimal(28,8)唯一金额调整前的换算数量。
unique_amount_deltadecimal(28,8)带方向的金额匹配调整。
unique_amount_directionstring · ≤10UP 或 DOWN。
pay_amountdecimal(28,8)用于展示和转账的精确链上数量,不能取整。
payment_methodstring所选资产 / 网络,例如 USDT_TRC20。
payment_addressstring · ≤255本笔付款及其网络的收款地址。
payment_urlstring · URLHPP URL;站内支付使用相同订单的付款说明。
expires_atdatetime到期时间,格式 yyyy-MM-dd HH:mm:ss。
HTTP 200 · JSON
{
  "success": true,
  "order_id": "41ad45477bd444f3bd89f0bab7f571bb",
  "merchant_order_id": "ORDER-20261003-001",
  "product_type": "DIGITAL_SERVICE",
  "status": "WAITING_PAYMENT",
  "amount": 49.90,
  "currency": "USD",
  "base_pay_amount": 49.90,
  "unique_amount_delta": 0.001,
  "unique_amount_direction": "UP",
  "pay_amount": 49.901,
  "payment_method": "USDT_TRC20",
  "payment_address": "TExampleReceivingAddressForIllustrationOnly",
  "payment_url": "https://mochi.bz/pay/41ad45477bd444f3bd89f0bab7f571bb",
  "expires_at": "2026-10-03 15:30:00"
}
04

查询订单

使用且仅使用一个订单标识,查询属于已认证商户的订单。

GET https://mochi.bz/api/v1/orders/query
查询参数必填类型 / 长度说明
order_id二者之一string · 32MochiPay 订单标识。
merchant_order_id二者之一string · 1–100你的商户订单标识;若曾重复使用,将返回最新匹配订单。
使用 order_id ,存储后即确定。创建响应不明确时,先查询同一唯一商户订单编号,再判断结果;重复创建不保证幂等性。只发送一种标识。对准确的原始查询字符串签名,例如 merchant_order_id=ORDER-20260919-001.

查询示例

C# · 查询订单
string baseUrl = "https://mochi.bz";
string query = "merchant_order_id=ORDER-20260919-001";

using (var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(apiSecret)))
{
    string signature = Convert.ToBase64String(
        hmac.ComputeHash(Encoding.UTF8.GetBytes(query)));

    using (var client = new HttpClient())
    {
        client.DefaultRequestHeaders.Add("X-Mochi-Key", apiKey);
        client.DefaultRequestHeaders.Add("X-Mochi-Signature", signature);
        string json = await client.GetStringAsync(
            baseUrl + "/api/v1/orders/query?" + query);
    }
}
PHP 7.0–8.4 · 查询订单
<?php
$baseUrl = 'https://mochi.bz';
$apiKey = 'YOUR_API_KEY';
$apiSecret = 'YOUR_API_SECRET';
$query = http_build_query(
    ['merchant_order_id' => 'ORDER-20260919-001'],
    '',
    '&',
    PHP_QUERY_RFC3986
);
$signature = base64_encode(
    hash_hmac('sha256', $query, $apiSecret, true)
);

$ch = curl_init($baseUrl . '/api/v1/orders/query?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-Mochi-Key: ' . $apiKey,
        'X-Mochi-Signature: ' . $signature
    ],
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_TIMEOUT => 30
]);

$json = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($json === false) {
    throw new RuntimeException($error);
}

// Preserve decimal JSON numbers as text before decoding.
$json = preg_replace(
    '/("(?:amount|base_pay_amount|pay_amount|received_amount|exchange_rate|rate_markup_percent|unique_amount_delta)"\s*:\s*)(-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?)(?=\s*[,}])/',
    '$1"$2"', $json
);
$result = json_decode($json, true);
if ($httpCode < 200 || $httpCode >= 300 || empty($result['success'])) {
    throw new RuntimeException('MochiPay request failed. Review before retrying creation.');
}
?>

成功响应字段

查询返回 wallet_type 及 network 分别传入;创建订单会返回组合后的 payment_method。与本地订单保存的支付方式核对,仅向顾客浏览器返回必要付款字段。

字段类型 / 长度说明
order_idstring · 32MochiPay 订单标识。
merchant_order_idstring · ≤100你的商户订单标识。
sourcestring · ≤20订单来源,例如 API.
descriptionstring · ≤500订单说明。
product_typestring · ≤20PHYSICAL 或 DIGITAL_SERVICE.
product_infoJSON/string/null创建订单时提供的商品或购物车信息。
statusstring · ≤20订单整体付款状态。
merchant_statusstring · ≤50商户看到的订单状态。
amountdecimal(28,8)原始订单金额。
currencystring · ≤20原始订单币种,例如 USD, EUR, USDT 或 USDC.
base_pay_amountdecimal(28,8)用于唯一匹配调整前的换算付款数量。
unique_amount_deltadecimal(28,8)在基础数量上增加或减少的小额定向调整。
unique_amount_directionstring · ≤10UP 或 DOWN.
pay_amountdecimal(28,8)客户必须支付的精确加密货币数量。
received_amountdecimal(28,8)目前收到的加密货币数量。
exchange_ratedecimal(38,18)订单创建时使用的汇率快照。
rate_markup_percentdecimal(9,4)本订单使用的商户汇率加价快照。
wallet_typestring · ≤20支付资产: USDT, USDC, BTC, ETH 或 SOL.
networkstring · ≤30区块链网络,例如 TRC20 或 ERC20.
payment_addressstring · ≤255本订单选择的商户收款地址。
tx_hashstring/null · ≤255检测到的客户付款交易哈希。
confirmationsinteger当前区块链确认数。
customer_email … postal_codestring/null创建订单时提供的可选客户与收货字段。
payment_urlstring · URLHPP 结账 URL;站内接入查询同一订单获取状态和付款说明。
expires_atdatetime订单到期时间。
paid_atdatetime/null付款完成时间。
created_atdatetime订单创建时间。
updated_atdatetime订单最近更新时间。
05

错误响应

错误返回 HTTP 状态码及稳定、可供程序识别的消息。

JSON
{ "success": false, "message": "INVALID_SIGNATURE" }
HTTP消息说明
400INVALID_JSON / INVALID_AMOUNT请求数据无效。
400INVALID_CURRENCY / INVALID_PAYMENT_METHOD不支持此币种或支付方式。
400INVALID_UNIQUE_AMOUNT_DIRECTION / INVALID_PRODUCT_TYPE不支持此方向或商品类型值。
400FIELD_TOO_LONG / INVALID_REDIRECT_URL / INVALID_NOTIFY_URL可选字段超过长度限制,或提供的 URL 无效。
400ORDER_ID_REQUIRED / ORDER_IDENTIFIER_CONFLICT缺少查询标识,或标识相互冲突。
401INVALID_API_KEY / INVALID_SIGNATURE身份验证失败。
403SUBSCRIPTION_REQUIRED / SUBSCRIPTION_EXPIRED商户订阅当前不可用。
403MERCHANT_DISABLED商户账户已禁用。
404ORDER_NOT_FOUND没有找到属于此商户的匹配订单。
500SYSTEM_ERROR请求未能完成。
06

旧版 SaaS 商城接入

Shopyy / Shopoem、Shoplus、Wooshoppaas 与 Fecify 仅兼容 HPP,无需下载插件或修改 SaaS 源码。

POST https://mochi.bz/api/v/orders/legacy_create/{MerchantApiKey}/{PaymentMethod}
URL 中使用 API Key,绝不能使用 API Secret。 此 URL 标识商户与支付方式。SaaS 平台继续发送其原有的 application/x-www-form-urlencoded 订单字段。

支持的平台

Shopyy / Shopoem同一公司,兼容的网关格式
Shoplus配置支付接口 URL
Wooshoppaas配置支付接口 URL
Fecify配置支付接口 URL

设置

  1. 从 MochiPay 商户后台复制商户 API Key。
  2. 为此 SaaS 支付选项选择一种支持的支付方式。
  3. 替换 {MerchantApiKey} 及 {PaymentMethod} 作为端点 URL 的一部分。
  4. 将完整 URL 粘贴到 SaaS 网关的接口或提交 URL 设置。
  5. 保留 SaaS 平台已有 POST 参数、返回 URL 与通知 URL。

URL 示例

旧版支付接口 URL
https://mochi.bz/api/v/orders/legacy_create/YOUR_MERCHANT_API_KEY/USDT_TRC20

https://mochi.bz/api/v/orders/legacy_create/YOUR_MERCHANT_API_KEY/USDC_ERC20

https://mochi.bz/api/v/orders/legacy_create/YOUR_MERCHANT_API_KEY/SOL_SOLANA

支付方式

USDT_TRC20USDT on TRON
USDC_ERC20USDC on Ethereum
BTC_BITCOINBitcoin 网络原生 BTC
ETH_ERC20Ethereum 网络原生 ETH
SOL_SOLANASolana 网络原生 SOL

旧版必填字段

参数用途
merchant_url原 SaaS 商城值,保留在完整请求记录中以便诊断。
system_name已有 SaaS 平台标识,会保留在完整请求记录中。
account_type / payment_mode保留平台原有值,通常为 live 及 sale.
orders_id原 SaaS 订单标识。
amount / currency原始订单金额与币种。
return_url确认付款后的客户返回 URL。
notify_url付款完成后的服务器通知 URL。
securityToken可选透传标记,将原样返回。
products可选商品或购物车数据。
customer_*现有客户、地址、IP 与 User-Agent 字段。

创建订单响应

现有 SaaS 接入从三段式纯文本响应中提取托管结账 URL。

文本
_____https://mochi.bz/pay/ORDER_ID_____

成功返回与通知字段

字段值
securityToken原样透传的原始值。
paymentMethodonlinepay
paymentStatusCompleted
paymentTransaction已确认的区块链交易哈希。
paymentCommentsMochiPay payment confirmed
orderID原有 SaaS 的 orders_id.

电商插件下载

通过对应平台扩展将 MochiPay 接入独立商城。请选择平台和版本分支。19 个下载包均为独立 ZIP,内含英文说明和 PHP 要求,请使用准确商城版本允许的 PHP 环境。

站内支付 + HPP

WooCommerce

经典结账、Checkout Blocks 和 HPOS。

平台WooCommerce 5.8 或更高版本,使用原生网关 API
PHPPHP 7.4–8.4

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

OpenCart 2.0–2.2

早期支付路由与版本特定的模板路径。

平台OpenCart 2.0.x-2.2.x
PHPPHP 5.6–7.4;更高版本需要商城核心补丁

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

OpenCart 2.3

独立的 2.3 扩展 / 支付目录结构。

平台OpenCart 2.3.x
PHPPHP 5.6–7.4;更高版本需要商城核心补丁

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

OpenCart 3

Twig 视图与 OpenCart 3 原生支付网关。

平台OpenCart 3.0.x
PHPPHP 5.6–8.4,并遵循确切的核心 / 依赖要求

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

OpenCart 4

原生 4.x 命名空间、路由与扩展包结构。

平台OpenCart 4.0.2.x-4.1.x
PHPPHP 8.0.2–8.4;4.1.0.4 需要 8.1+

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Zen Cart 1.5.3–1.5.7

旧版 define 语言文件与原生状态设置。

平台Zen Cart 1.5.3-1.5.7
PHPPHP 5.6–8.0,取决于商城核心版本

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Zen Cart 1.5.8–2.2

现代数组式语言文件与原生状态设置。

平台Zen Cart 1.5.8 / 2.0.x / 2.1.x / 2.2.x
PHPPHP 7.3–8.4,取决于商城核心版本

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Magento 1 / OpenMage

Magento CE 1.9.3.0–1.9.4.5,以及兼容的 OpenMage 19/20。

平台Magento CE 1.9.3.0–1.9.4.5;OpenMage 19/20 原生 M1 API
PHPPHP 5.6–8.4;PHP 8 需要兼容的 OpenMage 核心

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Magento 2

Magento Open Source 2.3.7–2.4.8,使用原生结账。

平台Magento Open Source 2.3.7–2.4.8,使用原生结账
PHPPHP 7.3–8.4,取决于商城核心版本

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

PrestaShop 1.6

PrestaShop 1.6.1 支付钩子与提交表单。

平台PrestaShop 1.6.1.x
PHPPHP 5.6–7.1

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

PrestaShop 1.7 / 8 / 9

PrestaShop 1.7.6–1.7.8、8.x 和 9.0.x 的 paymentOptions。

平台PrestaShop 1.7.6-1.7.8 / 8.x / 9.0.x
PHPPHP 5.6–8.4,取决于商城核心版本

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Shopware 6.6

Shopware 6.6 和 6.7 分别使用对应的原生处理器。

平台Shopware >=6.6.10.0 <6.7.0.0
PHPPHP 8.2.x / 8.3.x / 8.4.x

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Shopware 6.7

Shopware 6.6 和 6.7 分别使用对应的原生处理器。

平台Shopware >=6.7.0.0 <6.8.0.0
PHPPHP 8.2.x / 8.3.x / 8.4.x

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Drupal Commerce

适用于指定 Drupal 和 Commerce 分支的原生支付网关。

平台Commerce 2.40.x 搭配 Drupal 9.3–10.x;或 Commerce 3.3.10 至 3.3.x 搭配 Drupal 10.3–11.x
PHPDrupal 9.3–9.5:PHP 7.4–8.1;Drupal 10:PHP 8.1–8.3;Drupal 11:PHP 8.3–8.4;以实际 Drupal 版本允许的环境为准

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

EC-CUBE 4.3

通过 EC-CUBE 原生购买流程处理日元结账。

平台EC-CUBE >=4.3.0 <4.4.0
PHPPHP 8.1.x / 8.2.x / 8.3.x

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Bagisto 2.3

通过 Laravel 扩展包处理原生订单与发票。

平台Bagisto >=2.3.0 <2.4.0
PHPPHP 8.2.x / 8.3.x / 8.4.x(同时满足商城依赖锁文件的要求)

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

Sylius 2.0

接入原生 Payum 结账和 Sylius 支付状态机。

平台Sylius >=2.0.0 <2.1.0,搭配 PayumBundle 2.6+ / 兼容 Payum 1.7 的核心
PHPPHP 8.2.x / 8.3.x / 8.4.x(同时满足商城依赖锁文件的要求)

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

osCommerce 4.14

原生 V4 支付模块,不适用于早期 osCommerce 2.x 和 3.x。

平台osCommerce 4.14.x;原生 V4 orderPayment 模块接口
PHPPHP 7.4.x–8.3.x,以已安装的 osCommerce 版本和依赖锁文件为准

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →
站内支付 + HPP

thirty bees 1.6

适用于 thirty bees 1.6 的原生支付模块与订单历史。

平台thirty bees >=1.6.0 <1.7.0
PHPPHP 7.4.x / 8.0.x / 8.1.x / 8.2.x / 8.3.x;请使用对应的 thirty bees 发行包

英文安装说明与详细 PHP 环境表位于 ZIP 内。

下载 ZIP设置指南 →

新增适配器为初始接入版本。正式启用前,请在自己的测试商城完成安装和真实付款验收。

开始使用 MochiPay 开发

创建 MochiPay 账户,选择适合付款流程的接入方式。

开始使用