付款请求

请求

API URL: /merchant/payment

Note

✅ 必填 ⭕ 可選 ❌ 不適用

标头	内容	说明
Content-Type	text/plain
Authorization	{token_type} {access_token}	用空格连接 token_type 和 access_token

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单ID（应保持唯一性）
amount	字符串	✅	✅	交易金额（支持最多6位小数）
currency	字符串	✅	✅	请参阅 货币和通道
channel	字符串	✅	✅	请参阅 货币和通道
email	字符串	✅	❌	有效的電子郵件格式
phone	字符串	✅	❌	有效的手機號格格式，如 09123456789
bank_code	字符串	⭕	✅	如果提供此参数，您需要将其添加到签名字符串。
real_name	字符串	⭕	❌	适用于人民币交易，以符合中国政府法规。
callback_url	URL	✅	✅	用于接收 PTS 交易完成后的回调请求的 URL。
redirect_url	URL	✅	✅	当支付过程完成时，用户将被重定向到此 URL。
error_url	URL	⭕	❌	当支付过程錯誤或失敗时，用户将被重定向到此 URL。
timestamp	整数	✅	✅	请求时间戳（10位数字）
remark	字符串	⭕	❌	备注
sign	字符串	✅	❌	签名字符串

响应

PTS 提供三种支付请求的响应方式。

提示

您应该通知 PTS 客服以便根据实际使用情况进行配置。

重定向

返回一个包含 redirect_url 的 JavaScript 代码，用户将自动重定向到实际支付页面。

HTML

将一个 HTML 输入表单与自动提交的 JavaScript 返回给用户。确保 HTML 和 JavaScript 可以正常工作，然后将整个响应内容转发给用户。

JSON

返回 JSON 格式的请求结果（响应代码为 1000 时）

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单ID（应保持唯一性）
transaction_id	字符串	✅	✅	PTS 交易ID
channel	字符串	✅	✅	请参阅货币和通道
submit_currency	字符串	✅	✅	提交的货币
submit_amount	浮点数	✅	✅	提交的金额（支持最多6位小数）
accept_currency	字符串	✅	✅	实际支付的货币
accept_amount	浮点数	✅	✅	支付的金额（支持最多6位小数）
exchange_rate	浮点数	✅	✅	汇率
pay_url	URL	✅	✅	用于支付金额的网页
wallet_address	字符串	⭕	❌	专用于加密货币，如有需要，请通知客服人员
expired_at	整数	⭕	❌	专用于加密货币，如有需要，请通知客服人员
qr_code	字符串	⭕	❌	付款用QR码（限通道QRPH、INSTAPAY）
sign	字符串	✅	❌	签名字符串

{
    "code": "1000",
    "message": "Accepted",
    "data": {
        "user_id": "1",
        "order_id": "20210521184906",
        "transaction_id": "P12021052118495503889",
        "channel": "CNY2TRC",
        "submit_currency": "CNY",
        "submit_amount": 1000,
        "accept_currency": "USDT-TRC",
        "accept_amount": 165.9181999999,
        "exchange_rate": 0.1659182,
        "sign": "jgtOKfV48sOD2NjBZ4WhiAUMwTgux9fTH53jNzNR..."
    }
}