支付页面 API

锁定价格并提交订单

URL：POST /paymentPage/depositOrder/lock

请求参数

depositOrderId

string

充值订单 ID

merchantOrderId

string

商户方订单 ID

merchantOrderAmount

number

订单金额

merchantOrderExpireTime

number

订单过期秒数

chain

string

充值链（BSC / BTC / ETH / POLYGON / TRON）

asset

string

充值币种（BNB / BTC / ETH / MATIC / TRX / USD / USDC / USDT）

price

number

锁定价格

请求示例

curl -X POST https://api.satogate.io/paymentPage/depositOrder/lock \
  -H "Content-Type: application/json" \
  -H "FP-API-KEY: your-api-key" \
  -H "FP-SIGN: your-sign" \
  -H "FP-TIMESTAMP: 1681973331" \
  -d '{"depositOrderId": "deposit-001", "merchantOrderId": "order-123", "chain": "BSC", "asset": "BNB", "price": 320.5}'

{
  "depositOrderId": "deposit-001",
  "merchantOrderId": "order-123",
  "merchantOrderAmount": 100,
  "merchantOrderExpireTime": 1800,
  "chain": "BSC",
  "asset": "BNB",
  "price": 320.5
}

响应参数

字段	类型	说明
amount	number	需充值数量
asset	string	充值币种
chain	string	充值链
depositAddress	string	充值地址
price	number	锁定价格

响应示例

{
  "amount": 0.312,
  "asset": "BNB",
  "chain": "BSC",
  "depositAddress": "0x1234...abcd",
  "price": 320.5
}

解锁订单价格

URL：POST /paymentPage/depositOrder/unlock

请求参数

depositOrderId

string

充值订单 ID

merchantOrderId

string

商户方订单 ID

merchantOrderAmount

number

required

订单金额

merchantOrderExpireTime

number

订单过期秒数

请求示例

curl -X POST https://api.satogate.io/paymentPage/depositOrder/unlock \
  -H "Content-Type: application/json" \
  -H "FP-API-KEY: your-api-key" \
  -H "FP-SIGN: your-sign" \
  -H "FP-TIMESTAMP: 1681973331" \
  -d '{"depositOrderId": "deposit-001", "merchantOrderId": "order-123", "merchantOrderAmount": 100}'

{
  "depositOrderId": "deposit-001",
  "merchantOrderId": "order-123",
  "merchantOrderAmount": 100,
  "merchantOrderExpireTime": 1800
}

响应

成功时返回空响应体。

生成 Payment Page 跳转链接

URL：POST /paymentPage/gen_payment_page

请求参数

appKey

string

项目 API Key

secret

string

项目 API Secret

merchantAddressId

string

商户关联 ID（充值模式）

merchantOrderId

string

商户订单 ID（订单模式）

merchantOrderAmount

string

订单金额

merchantOrderExpireTime

number

订单过期秒数

请求示例

curl -X POST "https://api.satogate.io/paymentPage/gen_payment_page?appKey=your-key&secret=your-secret&merchantOrderId=order-123&merchantOrderAmount=100&merchantOrderExpireTime=1800" \
  -H "FP-API-KEY: your-api-key" \
  -H "FP-SIGN: your-sign" \
  -H "FP-TIMESTAMP: 1681973331"

响应

返回生成的 Payment Page 跳转链接。

Payment Page 页面参数

URL：GET /paymentPage/index

请求参数

uri

string

required

当前页面路径

merchantAddressId

string

商户关联 ID（充值模式）

merchantOrderId

string

商户方订单 ID（订单模式）

merchantOrderAmount

number

订单金额

merchantOrderExpireTime

number

订单过期时间（秒）

demo

string

是否用于展示

请求示例

curl -X GET "https://api.satogate.io/paymentPage/index?uri=/charge&merchantAddressId=user123" \
  -H "FP-API-KEY: your-api-key" \
  -H "FP-SIGN: your-sign" \
  -H "FP-TIMESTAMP: 1681973331"

响应参数

字段	类型	说明
name	string	商户或项目名称
ppUrl	string	Payment Page URL
priceLockSecond	number	价格锁定秒数
requestedDepositOrderInfo	object	充值订单信息
requestedDepositOrderInfo.id	string	订单 ID
requestedDepositOrderInfo.chain	string	区块链
requestedDepositOrderInfo.asset	string	币种
requestedDepositOrderInfo.price	number	锁定价格
requestedDepositOrderInfo.status	string	订单状态
requestedDepositOrderInfo.lastPriceLockedTime	integer	锁定时间
wallets	array	钱包列表
wallets[].address	string	地址
wallets[].chain	string	区块链
wallets[].chainId	string	链 ID
wallets[].tokens	array	支持的代币列表
wallets[].tokens[].symbol	string	代币符号
wallets[].tokens[].contract	string	合约地址
wallets[].tokens[].decimals	integer	精度
wallets[].tokens[].icon	string	图标 URL
wallets[].tokens[].minCharge	string	最小充值金额
wallets[].tokens[].enabled	boolean	是否支持充值

响应示例

{
  "name": "My Merchant",
  "ppUrl": "https://pay.satogate.io/charge",
  "priceLockSecond": 60,
  "requestedDepositOrderInfo": {
    "asset": "USDT",
    "chain": "BSC",
    "id": "deposit-001",
    "lastPriceLockedTime": 1681973331,
    "price": 1.0,
    "status": "CREATED"
  },
  "wallets": [
    {
      "address": "0x1234...abcd",
      "chain": "BSC",
      "chainId": "56",
      "tokens": [
        {
          "contract": "0x55d398326f99059fF775485246999027B3197955",
          "decimals": 18,
          "enabled": true,
          "icon": "https://example.com/usdt.png",
          "minCharge": "1",
          "symbol": "USDT"
        }
      ]
    }
  ]
}

认证

核心接口

支付页面

回调

锁定价格并提交订单

请求参数

请求示例

响应参数

响应示例

解锁订单价格

请求参数

请求示例

响应

生成 Payment Page 跳转链接

请求参数

请求示例

响应

Payment Page 页面参数

请求参数

请求示例

响应参数

响应示例

​锁定价格并提交订单

​请求参数

​请求示例

​响应参数

​响应示例

​解锁订单价格

​请求参数

​请求示例

​响应

​生成 Payment Page 跳转链接

​请求参数

​请求示例

​响应

​Payment Page 页面参数

​请求参数

​请求示例

​响应参数

​响应示例

锁定价格并提交订单

请求参数

请求示例

响应参数

响应示例

解锁订单价格

请求参数

请求示例

响应

生成 Payment Page 跳转链接

请求参数

请求示例

响应

Payment Page 页面参数

请求参数

请求示例

响应参数

响应示例