HMCTS支払いゲートウェイ
HMCTS Payment Gatewayは、Gov.uk Pay Serviceの小さなラッパーであり、基本的なユーザー/サービス承認を追加し、有用な支払い参照構造を実施し、複数のgov.uk Payアカウントでデータを収集し、より良い財務報告と調整を可能にします。
統合前提条件
HMCTS支払いゲートウェイとの統合を成功させるには、次のことが必要になります。
- gov.ukはAPIキーを支払います。開始する前に、専用のgov.ukペイアカウントを作成してください。それが完了したら、gov.uk Pay Admin Consoleを使用してAPIキー(-s)を作成し、それらを提供する必要があります。
- イダム。支払いゲートウェイへのすべてのリクエストでは、有効なユーザーJWTトークンを「承認」ヘッダーで渡す必要があります。開始する前に、アプリケーションがIdamと統合されていることを確認してください。
- service-auth-provider 。支払いゲートウェイへのすべての要求には、「ServiceAuthorization」ヘッダーで有効なサービスJWTトークンを渡す必要があります。アプリケーションがservice-auth-provider-appに登録されていることを確認し、サービスJWTトークンを取得できるようにしてください。
統合ゴトカ
- 古い支払いステータス。 HMCTS Payment GatewayもGov.ukも、支払いの「プッシュ」通知を支払うことはありません。したがって、ユーザーが支払いを行ったが、「リターン」URLへのリダイレクトが失敗した状況(たとえば、インターネット接続が中断されたため)は、再びステータスを照会するまでアプリケーションに反映されない支払いステータスにつながります。これを考慮し、必要に応じて、支払いステータスを更新するために背景ジョブを実装する必要があります。
- アクセス許可。支払いゲートウェイは、単純なURLベースの承認ルールを実装します。 ID 999を持つユーザーは、URLS/USERS/999/PAYMENTS/*へのアクセスのみが付与され、/{other_id}/支払い/*へのリクエストは403になります。
- 払い戻し。 HMCTS Payment GatewayとGov.uk Payの両方の払い戻しエンドポイントは両方とも、MOJの財務協定とバックオフィスシステムの制限のために機能しません。
建物
このプロジェクトは、Gradleをビルドツールとして使用しますが、 ./gradlew
ラッパースクリプトがあるため、ローカルにインストールしていません。
プロジェクトを構築するには、次のコマンドを実行してください。
テスト
このプロジェクトでは、データベースサポートにTestContainersを使用します。テストを実行しているマシンにDockerをインストールする必要があり、Docker環境には2GB以上の無料ディスクスペースが必要です。
Windowsユーザーは、この設定を有効にする必要がある場合がありますLinuxユーザーは、現在のユーザーをDockerグループに追加する必要がある場合があります。
$ sudo usermod -aG docker $USER
すべてのユニットテストを実行するには、次のコマンドを実行してください。
エンドポイント
- post/users/{userid}/支払い - 支払いを作成します
- get/users/{userid}/yutments/{paymentid} - 支払いを取得します
- post/users/{userid}/yutsments/{paymentid}/cancel-キャンセル支払い
詳細については、Swagger UIとgov.ukの支払いを参照してください。
便利なリンク
- https://gds-payments.gelato.io/docs/versions/1.0.0/resources/general
- https://github.com/hmcts/ccpay-reference-app
- https://github.com/hmcts/ccpay-reference-web
リキバーゼYAMLファイルを生成する方法
リキバーゼは、データベースの変更を更新するために使用されます。以下の手順を実行して、新しいYAMLファイルを作成および更新します。
- CDモデル
- コマンド$ MVNリキバゼを実行:diff
- これにより、API/SRC/Main/Resources/DB/Changelog/db.Changelog-0.0.5.55.yamlなどの新しいYAMLファイルが生成されます
- このファイルを、構成の下のdiffchangelogfileセクションでpom.xmlに追加します
- このファイルをdb.changelog-master.xmlのdiffファイルリストに追加します
環境変数
次の環境変数が必要です。
-
APPINSIGHTS_INSTRUMENTATIONKEY
、アプリの洞察キーテレメトリーイベントを送信します。