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

7.1.1 VAPYウォレット支払い注文の作成

#簡単な説明: VAPY ウォレット スキャン コード RMB リチャージ ビジネス インターフェイス。ユーザーは QR コードをスキャンすることで、ウォレット アカウントへの CNY のリチャージを完了できます。

リクエストパラメータ​
パラメータ名タイプ必須パラメータの意味パラメータの説明
keystringはい販売者キーAPIキー
localOrderIdstringはい販売者プラットフォームのローカル注文番号販売者プラットフォームはローカルで一意の注文番号を生成します。
localUserIdstringいいえ販売者プラットフォームのローカル ユーザー ID販売者プラットフォームのローカル ユーザー ID
amountnumberはいお支払い金額注文金額
notifyUrlstringはいコールバックアドレス注文が正常に完了すると、販売者の住所が API コールバックによって通知されます。 | (コールバックの詳細については、資料 3 を参照してください)
successRedirectUrlstringいいえ住所成功後に自動的にアドレスにジャンプします。
currencystringはい注文通貨注文通貨 (ウォレットでサポートされている通貨)
expireSecondLongいいえ有効期限のタイムスタンプ (秒)
signstringはい署名詳細については、「署名アルゴリズム」を参照してください。
JSON サンプルをリクエスト​
{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "173322",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 1,
  "currency": "USDT",
  "sign": "7f07092874886179997617567a98e20e"
}

応答 json の例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": "273719658252609",
    "localUserId": null,
    "localOrderId": "173322",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/scan-pay/JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke",
    "publicKey": "JJB7BvCtyxP3ieKk1pBpxnTposMtF4nvixsjdHCu7X8KEukfzB5h3bGa88Ke"
  }
}

返されたpaymentUrlにより、以下に示すように支払いページがポップアップ表示されます。

![img](/dx-docs/7- 7、数字币代收（充值）/7.1 VAPY钱包扫码支付/wallet.jpg)

応答データパラメータの説明​
パラメータ名タイプパラメータの意味パラメータの説明
orderIdstring注文ID
localUserIdstring販売者 ID
localOrderIdstring販売者のローカル注文番号
orderTypeenum注文タイプ
orderBizTypeenumオーダー事業orderBizType タイプの説明は次のとおりです。
paymentUrlstring住所支払い先住所
publicKeystring秘密鍵公開アクセスキー

orderBizType タイプの説明:​

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

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

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

コールバックデータ​
{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT"
}

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