サーバー側の変更
サンドボックス環境から本番環境へのスムーズな移行を促進するために、このドキュメントでは、移行プロセス中に調整が必要な構成の詳細と、これらの構成を正しく設定する方法について説明します。
ZOLOZ サンドボックス環境から本番環境への移行プロセスでは、コード内で構成されているホスト URL、ClientID、およびキー情報をサンドボックス設定から本番環境の設定に更新することに重点が置かれます。これは、ZOLOZ API をリクエストするときに、リクエストが本番環境サーバーに転送されるようにするためです。
コード内の構成情報は次のとおりです:
ホスト URL は、どの環境の ZOLOZ API がリクエストされているかを示すために使用されます。環境によって ClientID が異なり、キー情報はそれぞれの ClientID にバインドされています。したがって、サンドボックス環境から移行する場合は、ホスト URL、ClientID、およびキー情報を本番環境に提供された詳細に置き換える必要があります。これらの詳細を更新しないと、ZOLOZ API 呼び出し中にエラーが発生します。
コード内の構成情報を更新した後、基本的な機能が正しく動作することを確認するために、予備テストを実施することが不可欠です。これには、認証プロセスの開始、インターフェイス リクエストの成功の確認、認証のトランザクション ID が正しく取得されていることの確認などが含まれますが、これらに限定されません。
本番環境の接続構成を取得する方法
ホスト URL を取得する方法
指定されたログイン ポータル アドレスに基づいて、対応するホスト URL を識別できます。本番環境のポータル アドレスとそれぞれのホスト URL を以下に示します。
環境 | ZOLOZ ポータル アドレス | ベース API URI（ホスト URL） |
シンガポール本番 | https://sg-production-api.zoloz.com/ | |
香港本番 | https://hk-production-api.zoloz.net/ | |
インドネシア本番 | https://id-production-api.zoloz.com/ |
クライアント ID、加盟店の秘密鍵、および ZOLOZ の公開鍵を取得する方法
続行するには、まず ZOLOZ 本番環境でアクティブ化された管理者アカウントを持っている必要があります。アクティブ化された管理者アカウントを取得したら、対応するユーザー名とパスワードを使用して ZOLOZ 本番環境ポータルにログインできます。ログインに成功したら、図 1 に示すように、 ページに移動します。API キー ページ (図 1 を参照)。
図 1
クライアント ID を取得する方法
ユーザー名とパスワードを使用して ZOLOZ ポータルにログインし、図 1 に示すように APIキー。 ページに移動します。
「Client ID」文字列をコピーし、後で使用するためにローカル ワークスペースに保存します。
加盟店の秘密鍵と ZOLOZ の公開鍵を取得する方法
ユーザー名とパスワードを使用して ZOLOZ ポータルにログインし、図 1 に示すように APIキー ページに移動します。
「ZOLOZ トランザクション公開鍵」文字列をコピーし、後で使用するためにローカル ワークスペースに保存します。
自動生成 ボタンをクリックすると、RSA キーペアが生成されます。その中には次のものがあります。
公開鍵文字列は、クライアント トランザクション公開鍵 フィールドに自動的に入力されます。
注: 内容を変更しないでください。
秘密鍵文字列は、merchant_private_key.pem というファイルとしてローカル ワークスペースに自動的にダウンロードされます。
注: ZOLOZ はクライアント トランザクション秘密鍵を保存せず、ZOLOZ チームがクライアント トランザクション秘密鍵を要求することはありません。クライアント トランザクション秘密鍵を安全に保管し、誰とも共有しないでください。
送信 ボタンをクリックして、ZOLOZ システムにクライアント トランザクション公開鍵を登録します。
API 呼び出しエラー
エラー | 考えられる理由 | 解決策 |
SIGNATURE_INVALID | 抽出された署名文字列が、検証対象のコンテンツ文字列と一致しません。 | ZOLOZ のサンプル デモで正しい構成をご確認の上、API 認証情報を準備して使用するをご参照ください。 |
ACCESS_DENIED | アカウントには、現時点でこの特定の API へのアクセス権がありません。 | へのアクセスのみ[Real ID]API はデフォルトで有効になっています。ID 認識や顔比較などの他のプロダクト API については、追加のアクセスをリクエストする必要があります。 他のプロダクト API を呼び出すためのアクセス権を有効にするには、ZOLOZ のテクニカル サポートにお問い合わせください。 |
PRODUCT_QUOTA_LIMIT | API 呼び出しのテスト クォータ制限に達している可能性があります。 | ZOLOZ テクニカル スタッフに連絡して、ケースを処理してください。 sg-sandbox 環境、clientID、使用したメールアドレスなど、サンドボックス環境情報を提供する必要があります。 |
HIGH_RISK | リスク管理エンジンがトリガーされた可能性があります。 | サンドボックス環境でテストする際に高リスクとして検出されないようにするには、リスク管理を無効にします。初期化 API のリクエストパラメータ operationMode を異なる値に設定するか、デモ アプリで対応する リスク レベル を選択することで、これを行うことができます。 詳細は次のとおりです。
デモ アプリは次のようになります。
IDN と Velocity の定義は次のとおりです。
|
MERCHANT_NOT_FOUND | clientID、エンドポイント/URL、ZOLOZ 公開鍵、または加盟店秘密鍵に関してエラーが発生した可能性があります。 | 次の各構成が正しいことを確認してください。
** ポータル環境は、エンドポイント/URL 環境と一致している必要があります。
** 通常、この構成ミスは、MERCHANT_NOT_FOUND エラーではなく、INVALID_SIGNATURE エラーになります。 |
PARAM_MISSING | 必須のリクエスト パラメーターがありません。 | ドキュメントに従って、正しいリクエストパラメータ値を使用していることを確認してください。ドキュメント。 オプションのリクエスト パラメーターが渡された場合、パラメーター値を空にすることはできません。 |
SYSTEM_ERROR | 2 つの考えられる理由が発生した可能性があります。
|
|
