加盟店の管理
加盟店が認証APIを介して認証リクエストを行えるようにするには、加盟店エンティティを作成し、3DSリクエスターのクライアント証明書をダウンロードする必要があります。 認証リクエストに含まれていて、頻繁に変更されない詳細は、API機能の単純化のためにデータベースに格納されています。 加盟店エンティティの作成、表示、編集、削除プロセスは以下のとおりです。
加盟店の作成¶
加盟店を作成するには、まず管理インターフェイスのMerchantsページに移動し、Newボタンを選択します。
New merchant画面で、以下のフィールドを使用し、新しい加盟店を作成します。
ユーザーアクセス
ユーザーが加盟店を作成するには、Business adminロールが必要です。
重要
加盟店を作成するとき、または加盟店の詳細を編集するときは、加盟店名と加盟店IDの組み合わせは一意でなければならないことに注意してください。
詳細¶
Detailsは認証リクエストに使用される一般的な加盟店の詳細です。項目の説明は以下です。
- Merchant name - アクワイアラーによって割り当てられた加盟店の名前。これはオーソリゼーションメッセージ・リクエストで使用されるものと同じである必要があります。最大40文字
- Merchant ID - アクワイアラーによって割り当てられた加盟店の識別子。これはオーソリゼーションメッセージ・リクエストで使用されるものと同じである必要があります。最大35文字
Country - 加盟店の運営元の国。認証リクエストの一環として、ActiveServerはこのエントリーを使用しこれをMerchant Country Codeに変換します。これはオーソリゼーションメッセージ・リクエストで使用される値と一致している必要があります。
Default currency - 認証リクエストで使用されるデフォルト通貨。この値は、
purchaseCurrency
を指定することで、ブラウザベースの初期APIコールで上書きできます。- 3DS Requestor URL - 3DSリクエスターWebサイトまたは顧客ケアサイトの完全修飾URL。 このデータ要素は、問題が発生した場合に受信した3-Dセキュア・システムに追加情報を提供します。これには、連絡先情報を含める必要があります。
- Status - 加盟店がenabled(有効)かdisabled(無効)かを示すステータス。 加盟店を無効にすると、その特定の加盟店に対して認証APIリクエストが許可されなくなります。
- Notes - 管理者ユーザーが加盟店のメモにアクセスして編集できるようにするためのセクション。
ユーザーアクセス
ユーザーがStatusおよびNotesフィールドを表示および編集するには、Business adminロールが必要です。
国際ブランド¶
以下は認証リクエストに使用される国際ブランド固有の詳細です。
- Acquirer BIN - AReqメッセージを受信するDSによって割り当てられたアクワイアリング機関の識別コード。 ドロップダウンリストから既存のアクワイアラーを選択して入力するか、手動で入力する事ができます。最大11文字
- Requestor ID - DSが割り当てた3DSリクエスター識別子。各DSが、3DS2加盟店の登録が完了した後に各3DSリクエスターに個別に一意の識別子を提供します。最大35文字
- Requestor name - DSが割り当てた3DSリクエスター名。各DSが、3DS2加盟店の登録が完了した後に各3DSリクエスターに個別に一意の名前を提供します。最大40文字
- Category code - 加盟店の事業、製品、またはサービスの種類を説明するDS固有のコード。最大4文字
警告
上記のすべての国際ブランド固有の詳細は、認証リクエストの提供に必須です。これらのいずれかが存在しない場合、認証リクエストが失敗します。
加盟店詳細の表示¶
加盟店詳細を表示するには、管理インターフェイスのMerchantsページで加盟店を検索し、加盟店リストから加盟店を選択します。このページでは、加盟店のセキュリティも管理されます。
加盟店のセキュリティ¶
加盟店のクライアント証明書およびマーチャントトークン、およびサーバーCA証明書は、このページからアクセスできます。さらに、ユーザーはセキュリティーのためにデータ暗号化キーを管理できます。
注釈
証明書管理は、インスタンスがアクティブ化された後にのみ使用可能です。
クライアント証明書¶
3DSリクエスターのクライアント証明書は、加盟店がSSL認証の認証APIリクエストに含めるために必要です。
- Merchant token - 認証APIリクエストのHTTPヘッダーに追加されるトークン。 認証APIマスタークライアント証明書を使用して加盟店に代わって認証する場合にのみ必要です。認証APIマスタークライアント証明書はビジネス管理者ロールを持つユーザーにのみアクセスできるので、このフィールドはビジネス管理者ロールを持つユーザーにのみ表示されます。)マーチャントトークンでマスター証明書を使用する方法については、こちらを参照してください。
- Download - ユーザーがパスワードの指定後に.p12形式で3DSリクエスターのクライアント証明書をダウンロードすることを許可します。
- Revoke - セキュリティ違反または証明書の喪失が発生した場合に現在の3DSリクエスター・クライアント証明書を無効化し、加盟店にダウンロードおよび提供可能な新しい証明書を再発行します。
警告
クライアント証明書を失効させると、過去に発行された証明書は無効化され、代替証明書がインストールされるまで、加盟店はAPIリクエストを送信できなくなります。
CA証明書¶
- Download - 認証APIにリクエストを送信する際に必要なサーバーCA証明書をダウンロードします。この機能の詳細については、APIドキュメント概要を参照してください。
バージョン1.0.5
CA証明書のダウンロードはバージョン1.0.5でリリースされました。
ユーザーアクセス
ユーザーが証明書をダウンロードするには、Business admin、