10.3 キャッシュチャネル注文のクエリ(回収、支払い)
#簡単な説明: こ のインターフェースは、現金チャネルの回収および支払い注文を照会するために使用され、注文番号に従って注文の詳細を表示できます。
- リクエスト方法:POST
- リクエストインターフェイス: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/query/by-third ・リクエストメディアタイプ(JSONデータ形式)Content-Type: application/json
クエリパラメータ
| パラメータ名 | タイプ | 必須 | パラメータの意味 | パラメータの説明 |
|---|---|---|---|---|
orderId | string | いいえ | プラットフォーム注文番号 | プラットフォームの注文番号または販売者のローカル注文番号から 1 つを選択します |
localOrderId | string | いいえ | 販売者のローカル注文番号 | 2 つの販売者のローカル注文番号またはプラットフォームの注文番号のうち 1 つを選択します |
key | string | はい | 販売者キー | APIキー |
sign | string | はい | 署名 | 詳細については、「署名アルゴリズム」を参照してください。 |
JSON サンプルをリクエスト
{
"key": "9yUreYgTRtit39Dy",
"orderId": 274224939517780,
"sign": "07792d2cf97811d3f2e7bd98edb477e3"
}
戻り値
| パラメータ名 | タイプ | パラメータの意味 | パラメータの説明 |
|---|---|---|---|
code | int32 | リクエストステータス | 戻りコード、0 はビジネスが成功したことを意味し、それ以外の場合は別のエラーを表します。 |
success | boolean | 成功ステータス | 成功の識別。code=0 と一致し、互換性履歴に使用されます。 |
message | string | 説明 | エラーメッセージ。エラーがある場合は、エラー メッセージが返されます。 |
data | json | データを返す | 詳細については、以下のパラメータを参照してください。 |
例に戻る
{
"code": 0,
"success": true,
"message": null,
"data": {
"merchantId": 302992856974,
"merchantUserId": "conan",
"orderId": "477564506808517",
"localOrderId": "conantest9913279",
"type": "PAYMENT",
"status": "SUCCESS",
"currency": "CNY",
"paidAmount": "100",
"amount": "100",
"isReissue": false,
"notifyTime": 1772789295567,
"orderCreateTime": 1772789258844
}
}
データパラメータの説明
| パラメータ名 | タイプ | パラメータの意味 | パラメータの説明 |
|---|---|---|---|
merchantId | int64 | 販売者 ID | |
merchantUserId | string | 販売者のユーザー ID | 注文パラメータに対応する値 localUserId |
orderId | string | 注文番号 | 当社のプラットフォーム注文番号 |
localOrderId | string | 販売者のローカル注文番号 | 販売者のローカル プラットフォームの注文番号 (注文パラメータ localOrderId の値に対応) |
type | enum | 注文タイプ | |
status | enum | 注文状況 | |
currency | string | 注文通貨 | |
paidAmount | number | 受注残高と支払額 | |
amount | number | 注文金額 | |
isReissue | boolean | 再発行するかどうか | |
notifyTime | int64 | 通知のタイムスタンプ | ミリ秒 |
orderCreateTime | int64 | 注文作成タイムスタンプ | ミリ秒 |