Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

コールバック通知

ヒント (TIP)

支払いが完了した後、決済センターは関連する支払い結果と関連情報を加盟店に送信し、加盟店は処理を受信して応答を返す必要があります。バックグラウンド通知とのやり取りの際、決済センターが加盟店からの応答が成功しなかったり、タイムアウトしたりした場合、決済センターは通知が失敗したと見なします。通知は、通知の成功率を最大化するために一定のポリシーに従って定期的に再開されますが、通知が成功するという保証はありません。（通知の頻度は 0秒/15秒/30秒/3分/10分/20分/30分/60分/3時間/6時間 です）

警告 (WARNING)

注：同じ通知が加盟店システムに複数回送信される場合があります。加盟店システムは同じ通知を正しく処理できる必要があります。推奨される方法は次のとおりです。通知を処理する際、まず対応するビジネスデータのステータスを確認して、通知が処理されたかどうかを判断します。処理されていない場合は、再度処理します。処理されている場合は、直接成功結果を返します。状態の確認とビジネスデータの処理の前に、関数の再入によるデータの一貫性喪失を避けるため、データロックを使用して並行性制御を実行します。

危険 (DANGER)

注意：加盟店システムは、注文コールバックの内容に対して署名検証を行い、返された注文金額が注文金額と一致するかどうかを検証する必要があります。これを行う理由は、資金の損失につながる「虚偽の通知」を引き起こすデータ漏洩を防ぐためです。

インターフェースアドレス (Interface address)

POST 統合注文インターフェースによって送信された notify_url パラメータが設定されています。リンクにアクセスできない場合、サービスシステムは決済センターからの通知を受信できません。

リクエストボディ (Request Body)

名前
タイプ
説明
説明

app_id

string

アプリケーション

mch_id

string

加盟店

create_time

time

通知時間

resource_type

string

通知のリソースデータタイプ。支払い成功通知は encrypt-resource です。

event_type

string

通知タイプ。支払い成功通知のタイプは SUCCESS です。

resource

object

通知リソースデータ

» original_type

string

元のコールバックタイプは transaction です。

» algorithm

string

結果データを暗号化する暗号化アルゴリズムは、現在 AES-256-ECB のみがサポートされています。

» ciphertext

string

Base64 エンコードされたオン/オフ結果データ暗号文。有効な場合、暗号化されたコンテンツが返されます。復号化後、それは TransactionNotifyDetail の JSON 文字列になります。

» nonce

string

ランダムな文字列を使用して暗号化する

リクエスト例 (Request example)

戻り値の例 (Return example)

コールバックリクエストを正常に受信した後、通知サーバーに通知するには success を返してください。通知サーバーが success を受信すると、通知は停止します。それ以外の場合、通知は 0秒/15秒/30秒/3分/10分/20分/30分/60分/3時間/6時間 の頻度で10回送信されます。

前へ注文照会
次へ注文クローズ

最終更新