8.1.2 法定通貨支払い注文の作成
#簡単な説明: 現金（法定通貨）支払い（リチャージ）注文の取得
- リクエスト方法：POST
- リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/payment/create ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json
**注意: このタイプの注文のコールバック プロセス中に、当社のプラットフォームの支払い受け取りの遅延により注文がタイムアウトになり、コールバックが失敗する場合があります。ただし、支払いが受け取られると、システムは自動的に成功したコールバックを再発行します。したがって、販売者は status = "SUCCESS" (注文成功) コールバックを処理するだけで済みます。 **
リクエストパラメータ
| パラメータ名 | タイプ | 必須 | パラメータの意味 | パラメータの説明 |
|---|---|---|---|---|
key | string | はい | 販売者キー | APIキー |
localOrderId | string | はい | 販売者プラットフォームのローカル注文番号 | 販売者プラットフォームはローカルで一意の注文番号を生成します。 |
localUserId | string | いいえ | 販売者プラットフォームのローカル ユーザー ID | 販売者プラットフォームのローカル ユーザー ID |
notifyUrl | string | いいえ | コールバックアドレス | 注文が正常に完了すると、販売者のアドレスが API コールバックによって通知されます (コールバックの詳細は下部にあります)。 |
successRedirectUrl | string | いいえ | ジャンプアドレス | 成功後に自動的にアドレスにジャンプします。 |
channelCode | string | はい | チャンネルコード | ドキュメント 8.1.1 インターフェイスを通じてチャネル コード (channelCode フィールド) を取得します。 |
currency | string | はい | 通貨 | 注文価格の通貨 |
amount | number | はい | 金額 | 注文価格金額 |
localUserRealName | string | いいえ | ローカルユーザーの本名 | |
sign | string | はい | 署名 | 詳細については、「署名アルゴリズム」を参照してください。 |
JSON サンプルをリクエスト
{
"key": "dNNTJZpgFVWlYrVv",
"localOrderId": "conantest344",
"localUserId": "conan",
"notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
"isBlockchain": true,
"channelCode":"tencentest9",
"currency": "CNY",
"amount": "100",
"localUserRealName":"柯南",
"sign": "9662c0f104123b0ccac049108f174589"
}
応答 json の例
{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 352950471221317,
"localOrderId": "conantest344",
"uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
}
}
応答データパラメータの説明
| パラメータ名 | タイプ | パラメータの意味 |
|---|---|---|
orderId | long | 注文ID |
localOrderId | string | 販売者プラットフォームのローカル注文番号 |
uiUrl | string | 支払いリンクのアドレス |
コールバックの詳細
**注: このタイプの注文を持つ販売者がコールバック通知を処理する場合、当社のプラットフォームは支払いの受け取りを遅らせ、注文の収集がタイムアウトになり、失敗した注文のコールバック通知がトリガーされる可能性があります。実際にお金が受け取られると、システムは自動的に再発行の成功をコールバックします。 ** ** したがって、このような注文の場合、マーチャントは最終的な有効な結果としてステータス = "SUCCESS" (注文成功) のコールバックを処理するだけで済みます。 **
コールバック メソッドは次のとおりです: POST application/json
コールバックパラメータのjson化の例
{
"amount":"100",
"currency":"CNY",
"localOrderId":"conantest344",
"merchantId":302992856974,
"merchantUserId":"conan",
"notifyTime":1757577957437,
"orderCreateTime":1757577574425,
"orderId":"352950471221317",
"paidAmount":"100",
"status":"SUCCESS",
"type":"PAYMENT",
"isReissue":"true",
"sign":"774720acbacafca99af62b98d72154d3",
"key":"9yUreYgTRtit39Dy"
}
| パラメータ名 | タイプ | 参加署名 | パラメータの意味 | パラメータの説明 |
|---|---|---|---|---|
amount | decimal | はい | 注文金額 | |
currency | string | はい | 通貨 | |
localOrderId | string | はい | 販売者のローカル注文番号 | |
merchantId | string | はい | 販売者 ID | |
merchantUserId | string | はい | 販売者プラットフォームのローカル ユーザー ID | |
notifyTime | long | はい | コールバック時間 | ミリ秒 |
orderCreateTime | long | はい | 注文作成時間 | ミリ秒 |
orderId | string | はい | 注文番号 | |
paidAmount | decimal | はい | お支払い金額 | |
status | string | はい | 注文状況 | 成功: 完了しました |失敗: 失敗しました |
type | string | はい | 注文タイプ | PAYMENT 支払い、WITHDRAW 出金 |
isReissue | boolean | はい | 再発行 | true はい |
sign | string | いいえ | md5署名 | 詳細については、署名アルゴリズムを参照してください。 |
key | string | はい | 販売者キー |
コールバック通知を受信した場合は、処理が完了した後、メッセージが正常に受信され処理されたことを示す文字列 success を直接返してください。 シス テムが成功応答を受信すると、コールバックを繰り返し送信しなくなります。 予期した応答が受信されない場合 (成功が返されないか、例外が返された場合)、システムは段階的再試行メカニズムに従ってコールバック通知を再送信し、最大 14 回再試行します。 現在の再試行間隔は次のとおりです。 15秒、15秒、30秒、180秒、600秒、1200秒、1800秒、1800秒、1800秒、3600秒、10800秒、10800秒、21600秒、21600秒