API 开发文档

合规审核（使用前必读）

审核流程：

• 1. 提交商户注册信息（企业名称 / 联系人 / 业务说明）
• 2. 客服审核业务是否在合规范围内
• 3. 审核通过后，开放 API 接口权限并下发商户密钥
• 4. 开始对接，正常使用

→ 联系在线客服进行审核

接入网站支付接口

2.1 接口概览

平台提供标准 HTTP API，支持 POST 请求方式，返回 JSON 数据。当前支持的支付方式：

• USDC / USDT BSC（币安智能链）
• USDC / USDT TRON（波场网络）
• USDC / USDT Ethereum（以太坊主网）
• USDC / USDT Solana
• USDC / USDT Polygon

如需其它支付方式，请 联系客服 定制方案。

2.2 获取商户信息

登录商户后台 → 接口设置 → 查看并复制以下信息：

• 商户ID — 你的唯一商户标识
• 商户密钥 — 用于签名验证，请妥善保管
• 异步通知地址 — 支付成功后服务器回调地址（需公网可访问）
• 同步跳转地址 — 支付完成后用户浏览器跳转地址

2.3 创建订单

POST https://api.payone.uk/mapi.php

请求参数：

参数名	类型	必填	说明
pid	int	是	商户ID
type	string	是	支付币种，usdt 或 usdc
chain	string	否	链网络，可选：bsc / tron / ethereum / solana / polygon
out_trade_no	string	是	商户自定义订单号
notify_url	string	是	异步通知地址
return_url	string	否	同步跳转地址
name	string	是	商品名称
money	string	是	订单金额（单位：CNY）
sign	string	是	签名（见下方签名算法）
sign_type	string	是	签名类型，固定为 MD5

2.4 签名算法

将所有请求参数（除 sign 外）按参数名 ASCII 码升序排序，拼接成 key1=val1&key2=val2 格式，末尾追加商户密钥，计算 MD5：

// 1. 按参数名升序排序
money=100.00&name=test¬ify_url=https://your-site.com/callback.php&out_trade_no=ORDER20250101001&pid=1000&return_url=https://your-site.com/return.php&type=usdt

// 2. 追加商户密钥
money=100.00&name=test...&type=usdtYOUR_MERCHANT_KEY

// 3. MD5
sign = md5(上述字符串)

2.5 返回结果

创建订单接口返回 JSON：

{
  "code": 1,
  "msg": "Order created successfully",
  "trade_no": "PAY202501010001",
  "payurl": "https://api.payone.uk/cashier.php?...&sign=xxx"
}

将用户重定向到 payurl 即可拉起支付页面。

2.6 异步通知

支付成功后，平台会向 notify_url 发送 POST 请求：

参数名	类型	说明
trade_no	string	平台交易号
out_trade_no	string	商户订单号
type	string	支付币种
chain	string	链网络
name	string	商品名称
money	string	订单金额
trade_status	string	交易状态：TRADE_SUCCESS 表示支付成功
sign	string	签名（验证方式同上）

收款链接

3.1 收款链接说明

收款链接是平台提供的静态收款地址，商户可生成固定链接发送给付款方，用户点击后选择链网络、输入金额即可完成稳定币转账。

3.2 生成收款链接

登录商户后台 → 聚合收款 → 复制收款链接

3.4 使用方式

• 嵌入网站：在网站上放置按钮/链接，用户点击跳转到付款页面
• 社交媒体：将链接分享到 Telegram、WhatsApp、邮件等渠道
• 二维码：在后台直接下载收款链接对应的二维码图片
• API 生成：可通过接口动态创建收款链接（需联系客服开通）

需要帮助？

接入过程中遇到任何问题，随时联系我们的技术支持团队。

→ 联系在线客服