5.1.2 任意のウォレットへのデジタル通貨の出金を作成します (販売者が定義した為替レート)

#簡単な説明: デジタル通貨をウォレットの出金ビジネスインターフェースに引き出し、ユーザーがusdtを指定されたウォレットアドレスに送金できるようにします。 (販売者が定義した為替レートを設定するには、販売者のバックエンドにログインする必要があります)

リクエスト方法：POST
リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/pay/blockchain/custom/rate/create ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json

リクエストパラメータ

パラメータ名	タイプ	必須	パラメータの意味	パラメータの説明
`key`	`string`	はい	販売者キー	APIキー
`localOrderId`	`string`	はい	販売者プラットフォームのローカル注文番号	販売者プラットフォームはローカルで一意の注文番号を生成します。
`localUserId`	`string`	いいえ	販売者プラットフォームのローカルユーザー ID	販売者プラットフォームのローカルユーザー ID
`notifyUrl`	`string`	いいえ	コールバックアドレス	注文が正常に完了すると、販売者のアドレスが API コールバックリクエストによって通知されます (コールバックの詳細は下部にあります)。
`successRedirectUrl`	`string`	いいえ	住所	成功後に自動的にアドレスにジャンプします。
`currency`	`string`	はい	通貨	注文通貨
`network`	`string`	はい	メインネット	メインネット (現在は TRON、BSC、POLYGON、ETHEREUM のみをサポート)
`address`	`string`	はい	出金アドレス	出金アドレス
`quoteCurrency`	`string`	はい	注文見積通貨	注文見積通貨 (見積通貨の為替レートを設定するには、マーチャントバックエンドにログインする必要があります)
`quoteAmount`	`string`	はい	見積金額	見積金額
`isBlockchain`	`boolean`	いいえ	ブロックチェーン情報を返すかどうか (デフォルトは false)	true の場合、コールバックリクエストは注文チェーン上のトランザクション情報を伝達します。
`expireSecond`	`Long`	いいえ	有効期限のタイムスタンプ (秒)
`sign`	`string`	はい	署名	詳細については、「署名アルゴリズム」を参照してください。

JSON サンプルをリクエスト

{
  "key": "9yUreYgTRtit39Dy",
  "localOrderId":"conantest0128",
  "localUserId":"996",
  "currency":"USDT",
  "network":"TRON",
  "address":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "quoteCurrency":"CNY",
  "quoteAmount":"20",
  "sign":"f0ef4f925b899734727b77975ff9c0a3"
}

応答 json の例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
     "orderId": 473228783386885,
     "localUserId": "996",
     "localOrderId": "conantest0128",
     "orderType": "WITHDRAW",
     "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
     "targetType": "EXTERNAL",
     "network": "TRON",
     "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
     "currency": "CNY",
     "userCurrency": "USDT",
     "amount": "20",
     "userAmount": "20",
     "userReceivableAmount": "20",
     "rate": "1",
     "rateExpression": "1USDT≈1CNY"
     }
}

応答データパラメータの説明

パラメータ名	タイプ	パラメータの意味	備考
`orderId`	`string`	注文ID
`localUserId`	`string`	販売者のローカルユーザー ID
`localOrderId`	`string`	販売者のローカル注文番号
`orderType`	`enum`	注文タイプ
`orderBizType`	`enum`	受注業態	orderBizType タイプの説明は次のとおりです。
`targetType`	`enum`	ターゲットの種類	targetType タイプの説明は次のとおりです。
`network`	`string`	メインネットの種類
`address`	`string`	住所	オンチェーンの支払いアドレス
`currency`	`string`	注文通貨
`userCurrency`	`string`	到着通貨
`amount`	`string`	注文金額
`userAmount`	`string`	ユーザーが支払った金額
`userReceivableAmount`	`string`	ユーザー受取可能額
`rate`	`string`	為替レート
`rateExpression`	`string`	為替レートの式

orderBizType タイプの説明:

PAYMENT_WALLET_SCAN VAPYウォレットスキャンコード支払い
PAYMENT_TRANSFER デジタル通貨バインディングアドレス直接入金
PAYMENT_ANY_DIGITAL_SCAN QR コードをスキャンして、任意の金額のデジタル通貨を支払います
WITHDRAW_WALLET VAPY ウォレットにお金を引き出します
WITHDRAW_ANY_DIGITAL_WALLET デジタル通貨を任意のウォレットに引き出します
PAYMENT_FIXED_DIGITAL_SCAN デジタル通貨限定金額スキャンコード支払い
BATCH_PAY 一括支払い

targetType タイプの説明:

INTERNAL 内部アドレス
EXTERNAL 外部アドレス
USER ユーザー抽象アドレス

コールバックの詳細

コールバックメソッドは次のとおりです: POST application/json

コールバックパラメータのjson化の例

{
"amount":"10",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"currency":"CNY",
"extra":{
     "quoteAmount":"10",
     "quoteCurrency":"CNY",
     "quotePrice":"1"
        },
"localOrderId":"conantest0132",
"merchantActualAmount":"94.63",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"66.84",
"merchantUserId":"996",
"notifyTime":1772266852130,
"orderCreateTime":1772266745032,
"orderId":"473284157243653",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"8.5",
"userCurrency":"USDT",
"userMinerFee":"1.5",
"userReceivableAmount":"10",
"sign":"78ef83b365e77c66b0cc3a283f8ebae4",
"key":"9yUreYgTRtit39Dy"
}

パラメータ名	タイプ	参加署名	パラメータの意味	パラメータの説明
`amount`	`decimal`	はい	注文金額
`bizType`	`enum`	はい	注文タイプ	bizType タイプの説明は次のとおりです。
`currency`	`String`	はい	通貨
`key`	`String`	はい	販売者キー
`localOrderId`	`String`	はい	ローカル注文番号
`merchantActualAmount`	`decimal`	はい	販売者の実際の支払い額
`merchantCurrency`	`String`	はい	販売者の支払い通貨	デフォルトの通貨
`merchantId`	`String`	はい	販売者 ID
`merchantPaidAmount`	`decimal`	はい	販売者の支払額
`merchantUserId`	`String`	はい	ユーザーID
`notifyTime`	`long`	はい	コールバック時間
`orderCreateTime`	`long`	はい	注文作成時間
`orderId`	`String`	はい	注文番号
`status`	`String`	はい	支払い状況
`type`	`String`	はい	注文タイプ
`userAmount`	`decimal`	はい	ユーザー支払額
`userCurrency`	`String`	はい	ユーザー支払い通貨
`sign`	`String`	いいえ	md5署名	詳細については、署名アルゴリズムを参照してください。
`extra`	`object`	はい	次のパラメータが含まれます。
└見積金額	`number`	はい	注文見積金額
└見積通貨	`number`	はい	注文見積通貨
└お見積り価格	`string`	はい	注文見積価格
`userMinerFee`	`String`	はい	マイニング料金	出金マイニング手数料
`userReceivableAmount`	`String`	はい	ユーザー受取可能額	ユーザー受取可能額
`blockchain`	`object`	はい	チェーントランザクション情報	オーダーリクエストパラメータ isBlockchain が true の場合、コールバックリクエストはこのオブジェクト情報を伝えます。 (オンチェーントランザクションのみが関係する場合、isBlockchain パラメータが有効になります)
└ネットワーク	`String`	はい	メインネット
└受信者アドレス	`String`	はい	受信者のアドレス
└差出人住所	`decimal`	はい	送付先住所
└txId	`String`	はい	トランザクションID

bizType タイプの説明:

PAYMENT_WALLET_SCAN VAPYウォレットスキャンコード支払い
PAYMENT_TRANSFER デジタル通貨バインディングアドレス直接入金
PAYMENT_ANY_DIGITAL_SCAN QR コードをスキャンして、任意の金額のデジタル通貨を支払います
WITHDRAW_WALLET VAPY ウォレットにお金を引き出します
WITHDRAW_ANY_DIGITAL_WALLET デジタル通貨を任意のウォレットに引き出します
PAYMENT_FIXED_DIGITAL_SCAN デジタル通貨限定金額スキャンコード支払い
BATCH_PAY 一括支払い

コールバック通知を受信した場合は、処理が完了した後、メッセージが正常に受信され処理されたことを示す文字列 success を直接返してください。システムが成功応答を受信すると、コールバックを繰り返し送信しなくなります。予期した応答が受信されない場合 (成功が返されないか、例外が返された場合)、システムは段階的再試行メカニズムに従ってコールバック通知を再送信し、最大 14 回再試行します。現在の再試行間隔は次のとおりです。 15秒、15秒、30秒、180秒、600秒、1200秒、1800秒、1800秒、1800秒、3600秒、10800秒、10800秒、21600秒、21600秒

リクエストパラメータ​

JSON サンプルをリクエスト​

応答データパラメータの説明​

orderBizType タイプの説明:​

targetType タイプの説明:​

コールバックの詳細​

コールバック メソッドは次のとおりです: POST application/json​

コールバックパラメータのjson化の例​

bizType タイプの説明:​