12.2 支払い為替レートの取得(加盟店定義の為替レート)
#簡単な説明: 支払いマーチャントのカスタム為替レート インターフェイス (マーチャントのカスタム為替レート) を取得します。
- リクエスト方法:POST
- リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/utils/rate/payment/merchant ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json
クエリパラメータ
| パラメータ名 | タイプ | 必須 | パラメータの意味 | パラメータの説明 |
|---|---|---|---|---|
key | string | はい | 販売者キー | APIキー |
currency | string | はい | 通貨(注文通貨) | 例: CNY |
userCurrency | string | はい | ユーザーが実際に受け取った通貨 | 例: USDT |
sign | string | はい | md5署名 | 詳細については、「署名アルゴリズム (ドキュメント 2) |
JSON サンプルをリクエスト
{
"key": "9yUreYgTRtit39Dy",
"currency": "CNY",
"userCurrency": "USDT",
"sign":"dbc72adf640a82e0b21f98c50afb2881"
}
戻り値
| パラメータ名 | タイプ | パラメータの意味 | パラメータの説明 |
|---|---|---|---|
code | int | リクエストステータス | 通信ステータス 正常復帰:0、その他は失敗を示す。 |
success | boolean | 成功ステータス | 真の成功 |
message | string | 説明 | |
data | json | パラメータ | パラメータについては、次の説明を参照してください。 |
例に戻る
{
"code": 0,
"success": true,
"message": null,
"data": {
"baseCurrency": "USDT",
"quoteCurrency": "CNY",
"tradePair": "USDT/CNY",
"rate": 7.10324538,
"costRate": 0.14078072015020265,
"costReverseRate": 7.10324538,
"exchangeAction": "BUY",
"quoteExpression": "1USDT≈7.1032CNY",
"baseAmount": "14.078072",
"quoteAmount": "100"
}
}
データパラメータの説明
| パラメータ名 | タイプ | パラメータの意味 | パラメータの説明 |
|---|---|---|---|
baseCurrency | string | 基本通貨 | |
quoteCurrency | string | 見積通貨 | |
tradePair | string | 取引ペア | |
rate | string | 価格 | |
costRate | number | 価格を計算します ( FROM x レート = TO ) | |
costReverseRate | number | 価格を逆に計算します (TO x レート = FROM ) | |
exchangeAction | enum | 取引タイプ | 購入:購入|販売: 販売 |
quoteExpression | string | 為替レートの式 | 引用形式での表現 |
baseAmount | string | 基本金額 | 基本金額の例 |
quoteAmount | string | 見積金額 | 見積金額例 |