Skip to main content

​
锁定价格并提交订单

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}'

​
响应参数

字段类型说明
amountnumber需充值数量
assetstring充值币种
chainstring充值链
depositAddressstring充值地址
pricenumber锁定价格

​
响应示例

{
  "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}'

​
响应

成功时返回空响应体。

​
生成 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"

​
响应参数

字段类型说明
namestring商户或项目名称
ppUrlstringPayment Page URL
priceLockSecondnumber价格锁定秒数
requestedDepositOrderInfoobject充值订单信息
requestedDepositOrderInfo.idstring订单 ID
requestedDepositOrderInfo.chainstring区块链
requestedDepositOrderInfo.assetstring币种
requestedDepositOrderInfo.pricenumber锁定价格
requestedDepositOrderInfo.statusstring订单状态
requestedDepositOrderInfo.lastPriceLockedTimeinteger锁定时间
walletsarray钱包列表
wallets[].addressstring地址
wallets[].chainstring区块链
wallets[].chainIdstring链 ID
wallets[].tokensarray支持的代币列表
wallets[].tokens[].symbolstring代币符号
wallets[].tokens[].contractstring合约地址
wallets[].tokens[].decimalsinteger精度
wallets[].tokens[].iconstring图标 URL
wallets[].tokens[].minChargestring最小充值金额
wallets[].tokens[].enabledboolean是否支持充值

​
响应示例

{
  "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"
        }
      ]
    }
  ]
}