非同期ゲートウェイアダプタの作成

支払プラットフォームは支払 API 要求を受信すると、さらに評価を行うために要求をゲートウェイアダプタに渡します。アダプタは、非同期支払フローの最初のステップを表す processRequest メソッドをコールして要求評価プロセスを開始します。processRequest 実装は 3 つの部分に分けることができます。

最初に、ゲートウェイで理解できる支払要求オブジェクトを作成します。

次に、アダプタが要求を支払ゲートウェイに送信します。

最後に、アダプタが応答オブジェクトを作成し、ゲートウェイの応答からのデータを保存します。応答オブジェクトの種別は、元々行ったのが支払収集要求であったのか返金要求であったのかに応じて異なります。

顧客の銀行がトランザクションを処理して結果をゲートウェイに送信したら、ゲートウェイは最終的なトランザクションの状況を提供する準備ができたことを示す通知をアダプタに送信します。非同期トランザクションフローのこの部分のために、アダプタは processNotification クラスをコールする必要があります。processNotification 実装は 4 つの部分に分けることができます。

最初に、アダプタが通知要求の署名を確認します。署名の確認についての詳細は、[TOPIC] を参照してください。

次に、アダプタがゲートウェイの通知要求を解析し、通知オブジェクトを作成します。getPaymentGatewayNotificationRequest メソッドによってゲートウェイの通知要求項目からのデータが評価されます。これには、状況、referenceNumber、イベント、金額が含まれます。プラットフォームが正常に通知を受信したかどうかに基づいて、notificationStatus オブジェクトが [成功] または [失敗] に設定されます。通知のイベントコードでゲートウェイが支払収集トランザクションを処理したことが示されている場合、アダプタは CaptureNotification クラスを使用して通知オブジェクトを作成します。イベントコードでゲートウェイが返金トランザクションを処理したことが示されている場合、アダプタは ReferencedRefundNotification クラスを使用して通知オブジェクトを作成します。 次に、アダプタは支払プラットフォームが通知の結果を記録することを要求します。 プラットフォームが正常に通知のデータを保存したかどうかに関係なく、すべての非同期ゲートウェイでは、プラットフォームが通知を受信したことを肯定応答する必要があります。プラットフォームは GatewayNotificationResponse クラスをコールして肯定応答を送信します。