メインコンテンツまでスキップ

5.1.1 デジタル通貨を作成してウォレットに引き出す

#簡単な説明: デジタル通貨をウォレットの出金ビジネスインターフェースに引き出し、ユーザーがusdtを指定されたウォレットアドレスに送金できるようにします。 (市場為替レート)

リクエストパラメータ​
パラメータ名タイプ必須パラメータの意味パラメータの説明
keystringはい販売者キーAPIキー
localOrderIdstringはい販売者プラットフォームのローカル注文番号販売者プラットフォームはローカルで一意の注文番号を生成します。
localUserIdstringいいえ販売者プラットフォームのローカル ユーザー ID販売者プラットフォームのローカル ユーザー ID
amountnumberはい金額注文金額
networkstringはいメインネットメインネット (現在は TRON、BSC、POLYGON、ETHEREUM のみをサポート)
addressstringはい出金アドレス出金アドレス
notifyUrlstringいいえコールバックアドレス注文が正常に行われた後、販売者のアドレスは API コールバック リクエストによって通知されます (コールバックの詳細については、ドキュメント 3 を参照してください)。
currencystringはい通貨注文通貨
userCurrencystringはいユーザーが実際に受け取った通貨ユーザーが実際に受け取った通貨
successRedirectUrlstringいいえ住所成功後に自動的にアドレスにジャンプします。
isBlockchainbooleanいいえブロックチェーン情報を返すかどうか (デフォルトは false)true の場合、コールバック リクエストは注文チェーン上のトランザクション情報を伝達します。
expireSecondLongいいえ有効期限のタイムスタンプ (秒)
signstringはい署名詳細については、「署名アルゴリズム」を参照してください。
JSON サンプルをリクエスト​
{
  "key": "weOfDMRpUAvAeOs5",
  "localOrderId": "TestOTM0625ROB017",
  "notifyUrl": "http://www.baidu.com/728-TestOTM0625ROB01",
  "amount": 20,
  "network": "TRON",
  "currency": "CNY",
  "userCurrency": "USDT",
  "successRedirectUrl": "http://www.baidu.com",
  "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
  "isBlockchain": true,
  "sign": "834e924f7846fe3a65b53e6680c8e53a"
}

応答 json の例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  
        "orderId": 473220978729221,
        "localUserId": null,
        "localOrderId": "TestOTM0625ROB017",
        "orderType": "WITHDRAW",
        "orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
        "targetType": "EXTERNAL",
        "network": "TRON",
        "address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
        "currency": "CNY",
        "userCurrency": "USDT",
        "amount": "20",
        "userAmount": "2.994723",
        "userReceivableAmount": "2.994723",
        "rate": "6.67841204",
        "rateExpression": "1USDT≈6.6784CNY"
        }
}
応答データパラメータの説明​
パラメータ名タイプパラメータの意味備考
orderIdstring注文ID
localUserIdstring販売者のローカル ユーザー ID
localOrderIdstring販売者のローカル注文番号
orderTypeenum注文タイプ
orderBizTypeenum受注業態orderBizType タイプの説明は次のとおりです。
targetTypeenumターゲットの種類targetType タイプの説明は次のとおりです。
networkstringメインネットの種類
addressstring住所オンチェーンの支払いアドレス
currencystring注文通貨
userCurrencystring到着通貨
amountstring注文金額
userAmountstringユーザーが実際に受け取った金額
userReceivableAmountstringユーザー受取可能額
ratestring為替レート
rateExpressionstring為替レートの式

orderBizType タイプの説明:​

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

targetType タイプの説明:​

  1. INTERNAL 内部アドレス
  2. EXTERNAL 外部アドレス
  3. USER ユーザー抽象アドレス

コールバックは JSON データを返します​

デフォルトでは、すべての callback パラメータが署名検証に参加します。コールバックパラメータの詳細については、「コールバック](/docs/dx-docs/3、回调)」を参照してください。

コールバックデータ​
{
"amount":"20",
"bizType":"WITHDRAW_ANY_DIGITAL_WALLET",
"blockchain":{
               "network":"TRON",
               "receiverAddress":"TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
               "senderAddress":"TE35TrUfHjbGEBsVS6zVXdHS8HxXCWwC2y",
        "txId":"c5503ecf1f0979d5bc7a7e16c3cad20290449913ab47a7e18dfca6ba6f2725fa"
              },
"currency":"CNY",
"localOrderId":"TestOTM0625ROB017",
"merchantActualAmount":"57.32",
"merchantCurrency":"CNY",
"merchantId":302992856974,
"merchantPaidAmount":"20",
"notifyTime":1772259079786,
"orderCreateTime":1772259032870,
"orderId":"473220978729221",
"status":"SUCCESS",
"type":"WITHDRAW",
"userAmount":"2.994723",
"userCurrency":"USDT",
"userMinerFee":"0",
"userReceivableAmount":"2.994723",
"sign":"742e64d684648c32c7ad33cf8d5604e2",
"key":"9yUreYgTRtit39Dy"
}

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