创建收单订单

POST /payment/createPaymentOrder

商户发起收单订单，并收到支付页面的链接，用户跳转并支付后，系统会向商户提供的回调地址发送支付结果通知。

信息

支付页面访问规则

接口返回字段 paymentUrl 为支付页面路径，需要拼接 Pay Protocol 官方域名才能访问：
- 正式环境：https://payment.payprotocol.network + paymentUrl
- 沙盒环境：https://payment-sandbox.payprotocol.network + paymentUrl
注意：请勿直接使用返回的 paymentUrl，必须拼接官方域名以避免误用或安全风险。
收单脚本支付金额确认范围

若支付金额超出以下范围，需用户提交转账交易 Hash 进行人工确认；也可通过订单修复工具修改订单金额后处理。
- 最大支付金额：付款金额不能超过订单金额的 1.2 倍（即最多多付 20%）。
- 最小支付金额：付款金额不能低于订单金额的 一半（即最少支付 50%）。

Request

application/json

Body

chainId int32required

链 ID

此为平台内部 ID，不是链上或者钱包里的链 ID，可以从查询链列表接口获取

description stringrequired

订单描述

outTradeNo stringrequired

商户订单号

isLegalTender integerrequired

Possible values: [0, 1]

报价币种是否为法币

0 - 否
1 - 是

quoteCurrencySymbol stringrequired

报价币种符号，必须为大写字母

注：报价币种为法币时，该字段为国际标准法币符号，如 USD、CNY，否则为数字货币符号，如 USDT、TRX、ETH

quoteAmount stringrequired

报价金额

注：是实际金额，必须为正数，可为小数

notifyUrl urirequired

商户回调地址

必须为公网可访问的 HTTPS 协议地址，否则无法接收到回调通知

redirectionUrl uri

用户支付成功后的跳转地址

Responses

application/json

Schema
Example (from schema)
Example

Schema

code int32required

状态码

msg stringrequired

成功或错误提示

description string

错误提示详情

data

object

required

outPaymentNo stringrequired

支付单号

paymentUrl stringrequired

支付页面的链接

userWalletAddress stringrequired

用于收款的子合约账户地址

saltHash stringrequired

用于验证子合约账户的盐值哈希

{
  "code": 0,
  "msg": "string",
  "description": "string",
  "data": {
    "outPaymentNo": "string",
    "paymentUrl": "string",
    "userWalletAddress": "string",
    "saltHash": "string"
  }
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "outPaymentNo": "202312181035353064079",
    "paymentUrl": "/payment?apiSign=na%2FcPNFSRrx4izPwaAemCibbJLUCGP64B5mJ60upO1Q%3D",
    "saltHash": "0x657faff79490a0c7a7d798d23d6b119e5eacc8f850f99a44e32b0a6cf9da6b11",
    "userWalletAddress": "TBqJ84AKTezZnzRN5nJs1k3yD2LUbQa23K"
  }
}

创建收单订单

/payment/createPaymentOrder

Request​

Body

Responses​

Request

Responses