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

6.1.3 OTC 支払注文の作成

#簡単な説明: OTC を通じた法定通貨の引き出し

リクエストパラメータ​

パラメータ名タイプ必須パラメータの意味パラメータの説明
keystringはい販売者キーAPIキー
localOrderIdstringはい販売者プラットフォームのローカル注文番号販売者プラットフォームはローカルで一意の注文番号を生成します。
localUserIdstringいいえ販売者プラットフォームのローカル ユーザー ID販売者プラットフォームのローカル ユーザー ID
notifyUrlstringいいえコールバックアドレス注文が正常に処理されると、販売者のアドレスが API コールバックによって通知されます (コールバックの詳細は下部にあります)。
currencystringはい出金通貨デフォルトの人民元
amountnumberはい出金額クォータをカスタマイズすることもできます (チャネル手数料の割引は受けられません。この注文のデフォルトの取引速度は NOW です)。ドキュメント 6.1.2 インターフェイスを介して注文金額を取得することもできます (この金額はチャネル手数料の割引を受けることができます)。
methodstringはいお支払い方法ALIPAY（アリペイ）、UNIONPAY（銀聯カード）、WECHAT（微信）、DIGITAL_RMB（デジタル人民元）
paymentDatajsonはいお支払い情報以下のコードリクエストサンプルを参照してください。
└受取人
└アカウントID
｜
└受取人
└アカウントId
｜
└カード番号
└受取人
└銀行名
｜
└受取人
└ウォレットコード
stringはいpayee (受取人名)、accountId (支払い口座番号)、cardNo (銀行カード番号)、bankName (銀行名)、walletCode (デジタル人民元コード)パラメータの例:
Alipay 支払いパラメータ
{ "payee":"Conan","accountId":13888888888}

WeChat 支払いパラメータ
{ "payee":"Conan","accountId":13888888888}

UnionPay カード支払いパラメータ
{ "payee":"Conan","cardNo":13888888888,"bankName":"中国銀行"}

デジタル人民元支払いパラメータ
{ "payee":"Conan","walletCode":13888888888}
speedstringはいトランザクション速度文書 6.1.1 インターフェースを通じて取得できます (「NOW」の場合、この注文は照合プールに入らず、オペレーターによって手動で直接処理されることを意味します)。
signstringはい署名詳細については、「署名アルゴリズム」を参照してください。

JSON サンプルをリクエスト

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "899952123",
  "localUserId": "4114",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo1/notify/test",
  "currency": "CNY",
  "amount": 100,
  "method": "UNIONPAY",
  "paymentData": {
                    // 银联卡
                    "payee":"柯南",
                    "cardNo":13888888888,
                    "bankName":"中国银行"
                   
                   //  支付宝
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  微信
                   // "payee":"柯南",
                   // "accountId":13888888888
                   
                   //  数字人民币
                   // "payee":"柯南",
                   // "walletCode":13888888888                
                  },
    "speed": "NOW",
    "sign":"c6e3c292bb8cafaea50d4001185e6112"
}

応答例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
  。        "orderId": 415236189438341,
            "localOrderId": "899952123"
           }
}
応答データパラメータの説明​
パラメータ名タイプパラメータの意味
orderIdLong注文番号
localOrderIdstring販売者プラットフォームのカスタム注文番号

コールバックの詳細​

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

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

{ 
   "amount":"100",
   "currency":"CNY",
   "localOrderId":"8999521232121336",
   "merchantId":302992856974,
   "merchantUserId":"4114",
   "notifyTime":1766134282162,
   "orderCreateTime":1766133956739,
   "orderId":"423044353278405",
   "status":"SUCCESS",
   "sign":"563eabc8cff14e401d426ff385b643ba",
   "key":"9yUreYgTRtit39Dy"
}
パラメータ名タイプ参加署名パラメータの意味パラメータの説明
amountdecimalはい注文金額
currencyStringはい通貨
localOrderIdStringはいローカル注文番号
merchantIdLongはい販売者 ID
merchantUserIdStringはい販売者のユーザー ID
notifyTimeLongはいコールバック時間
orderCreateTimeLongはい注文作成時間
orderIdStringはい注文番号
statusStringはい支払い状況成功: 完了しました |失敗: 失敗しました
signStringいいえmd5署名詳細については、署名アルゴリズムを参照してください
keyStringはいAPIキー

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