決済サービスプロバイダー

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

サービスプロバイダーは、Connectパイプラインとの対話を容易にするために設計されたラッパーオブジェクトです。プロバイダーは、Connectパイプラインを呼び出す以外のロジックを実装しません。すべてのビジネスロジックは、パイプラインプロセッサに実装されます。

プロバイダー内のメソッドごとに、対応するRequestオブジェクトとResultオブジェクトが使用されます (たとえば、GetCarts GetCartsRequestオブジェクトを受け取り、GetCartsResultオブジェクトを返します)。場合によっては、同じデータを返すときに応答オブジェクトが再利用されます。

デフォルトの要求引数と結果引数のカスタマイズされたバージョンは、オーバーロードされたジェネリックベースのメソッドを呼び出すことによって使用できます。

Paymentsサービスプロバイダーには、支払いデータを操作するための次のメソッドが含まれています。

GetPaymentOptionsメソッド

GetPaymentOptionsメソッドは、外部コマースシステムに対して支払いオプションデータをクエリし、支払いオプションのコレクションを返すために使用されます。

名前：	GetPaymentOptions (支払いオプションの取得)
形容：	指定した条件に一致するカートを取得します。 GetPaymentOptionsパイプラインを呼び出します。
使い：	支払いオプションのリストが必要な場合に呼び出されます。たとえば、次のようなものがあります。ショップの支払いオプションの場合、リストを取得します。
署名：	GetPaymentOptionsResult GetPaymentOptions(NotNullGetPaymentOptionsRequestリクエスト)
インプット：
	ShopName – オプション。支払いオプションを取得するショップの名前。
アウトプット：
	IEnumerable<PaymentOption> – 要求されたストアの支払いオプションのコレクション。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var paymentService = new PaymentServiceProvider();
var request = new GetPaymentOptionsRequest("WebShop");
var result = paymentService.GetPaymentOptions(request);

GetPaymentMethodsメソッド

GetPaymentMethods方法は、外部のコマースシステムに対して支払いデータをクエリし、特定の支払いオプションのすべての支払い方法を取得するために使用されます。

名前：	GetPaymentメソッド
形容：	指定した条件に一致する支払い方法を取得します。 GetPaymentMethodsパイプラインを呼び出します。
使い：	支払い方法のリストが必要な場合に呼び出されます。たとえば、次のようなものがあります。特定の支払いオプションの種類の支払い方法を取得します。
署名：	GetPaymentMethodsResult GetPaymentMethods(NotNullGetPaymentMethodsRequestリクエスト)
インプット：
	PaymentOption - 支払い方法を取得する支払いオプション。
	ShopName - オプション – ショップの名前。
アウトプット：
	IEnumerable<PaymentMethod> – 要求されたオプションの支払い方法のコレクション。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var paymentService = new PaymentServiceProvider();
var paymentOption = new PaymentOption
{
    Name = "Visa", 
    PaymentOptionType = new PaymentOptionType(1, "CreditCard"), 
    ShopName = "webShop"
};
var request = new GetPaymentMethodsRequest(paymentOption);
var result = paymentService.GetPaymentMethods(request);

GetPricesForPaymentsメソッド

GetPricesForPaymentsメソッドは、カート内のすべてのアイテムの可能な支払い価格のリストを取得するために使用されます。

名前：	GetPricesForPayments(支払いのための価格)
形容：	指定した条件に一致する支払コストを取得します。 GetPricesForPaymentsパイプラインを呼び出します。
使い：	支払いコストのリストが必要な場合に呼び出されます。
署名：	GetPricesForPaymentsResult GetPricesForPayments(GetPricesForPaymentsRequestリクエスト)
インプット：
	ShopName - 必須 – 現在のショップの名前。
	支払い検索 – 必須 – 支払い方法と検索するオプションの組み合わせ
	カート – 必須 – 検索する品目を含むカート。
アウトプット：
	ReadOnlyCollection<PaymentPrice> – カート内のアイテムにマッピングされた支払い価格のコレクション。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var paymentLookupList = new List<PaymentLookup>
{
    new PaymentLookup
    {
        OptionId = "{B83E4AA3-5F98-4FEE-95C0-BDE9CE572E7C}",
        LineItemIds = new List<string> {"1", "2"}.AsReadOnly()
    },
    new PaymentLookup
    {
        OptionId = "{B83E4AA3-5F98-4FEE-95C0-BDE9CE572E7C}",
        MethodId = "{8BC8E1DA-4FA8-4D20-AB53-53C104CCC2CC}"
    }
};
var cartProvider = (CartServiceProvider)Factory.CreateObject("cartServiceProvider", true);
var cartRequest = new LoadCartRequest("StarterKit", "cartid");
var cartResult = cartProvider.LoadCart(cartRequest);
var cart = cartResult.Cart;
var provider = (PaymentServiceProvider)Factory.CreateObject("paymentServiceProvider", true);
var request = new GetPricesForPaymentsRequest("StarterKit", paymentLookupList, cart);
var result = provider.GetPricesForPayments(request);
if (result.Success && result.PaymentPrices != null)
{
    foreach (var paymentPrice in result.PaymentPrices)
    {
        // handle payment price.
    }
}

GetPaymentServiceUrlメソッド

GetPaymentServiceUrlメソッドは、決済サービスとのトランザクションを初期化し、決済サービスの支払い受け入れページのURLを取得するために使用されます。

名前：	GetPaymentServiceUrl (英語)
形容：	フェデレーション決済サービスの決済承認ページのURLを取得します。
使い：	Webサイトが顧客から支払い情報を取得する準備ができたときに呼び出されます。たとえば、次のようなものがあります。チェックアウト時に支払い受け入れページをレンダリングする場合。
署名：	GetPaymentServiceUrlResult GetPaymentServiceUrl(NotNull GetPaymentServiceUrlRequestリクエスト)
インプット：
	HostPageOrigin – 必須です。支払い承認ページをホストするマーチャントWebサイトページのルートURLを指定します。
	AllowPartialAuthorization – オプション。トランザクションで部分的な承認を許可するかどうかを指定します。
	AllowVoiceAuthorization – オプション。トランザクションで音声認証を許可するかどうかを指定します。
	CardType – オプション。トランザクションで受け入れることができる支払カードのタイプを指定します。
	市区町村 – オプション。請求先住所または配送先住所の市区町村を指定します。
	ColumnNumber – オプション。支払い承認ページが入力フィールドを表示するときに使用する列数を指定します。
	国 – オプション。請求先住所または配送先住所の国を指定します。
	CurrencyCode – オプション。トランザクションで使用する通貨を指定します。通貨コードの形式は、使用されている決済サービスプロバイダーによって異なります。
	DisabledTextBackgroundColor - 省略可能。支払承認ページで無効にしたテキストの背景色を指定します。
	FontFamily – オプション。支払い承認ページのテキストのフォントファミリを指定します。
	FontSize – オプション。支払受理ページのテキストのサイズを指定します。
	IndustryType – オプション。トランザクションの業種を指定します。
	LabelColor – オプション。支払受け入れページのラベル・テキストの色を指定します。
	ロケール – オプション。支払い受け入れページの地域/ロケール/言語を指定します。
	PageBackgroundColor – オプション。支払受け入れページの背景色を指定します。
	PageWidth – オプション。支払受付ページの幅を指定します。
	PostalCode – オプション。請求先住所または配送先住所の郵便番号を指定します。
	PurchaseLevel – オプション。実行するトランザクションの購入レベルを指定します。
	ShowSameAsShippingAddress – オプション。請求先住所と配送先住所が同じであることを示すチェックボックスを表示するかどうかを指定します。
	状態 – オプション。請求先住所または配送先住所の状態を指定します。
	StreetAddress – オプション。請求先住所または配送先住所の住所を指定します。
	SupportCardSwipe – オプション。取引を完了するためにカードのスワイプがサポートされているかどうかを指定します。
	SupportCardTokenization – オプション。トランザクション中に入力されたカード情報をトークン化するかどうかを指定します。
	TextBackgroundColor – オプション。支払い受け入れページのテキストの背景を指定します。
	TextColor – オプション。支払受け入れページのテキストの色を指定します。
	TransactionType – オプション。実行するトランザクションのタイプを指定します。
アウトプット：
	URL – 指定されたオプションを使用してトランザクションを実行する支払い受け入れページのURL。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var request = new GetPaymentServiceUrlRequest()
{
    AllowPartialAuthorization = false,
    AllowVoiceAuthorization = false,
    CardType = CardType.AllCardTypes,
    ColumnNumber = 1,
    CurrencyCode = "USD",
    DisabledTextBackgroundColor = "#E4E4E4",
    FontFamily = "\"Helvetica Neue\", Helvetica, Arial, sans-serif",
    FontSize = "14px",
    IndustryType = "Ecommerce",
    LabelColor = "black",
    Locale = Context.Culture.Name,
    PageBackgroundColor = "white",
    PageWidth = "429px",
    PurchaseLevel = PurchaseLevel.Level1,
    ShowSameAsShippingAddress = false,
    SupportCardSwipe = false,
    SupportCardTokenization = true,
    TextBackgroundColor = "white",
    TextColor = "black",
    TransactionType = TransactionType.Authorize,
};
if (HttpContext.Current != null && HttpContext.Current.Request != null)
{
    request.HostPageOrigin = string.Format(
        System.Globalization.CultureInfo.InvariantCulture,
        "{0}://{1}",
        HttpContext.Current.Request.Url.Scheme,
        HttpContext.Current.Request.Url.Authority);
}
var provider = (PaymentServiceProvider)Factory.CreateObject("paymentServiceProvider", true);
var result = provider.GetPaymentServiceUrl(request);

GetPaymentServiceActionResultメソッド

GetPaymentServiceActionResultメソッドは、支払いサービスに対するトランザクションまたはアクションの結果を取得するために使用されます。

名前：	GetPaymentServiceActionResult (支払いサービスアクション結果)
形容：	フェデレーション決済サービスのトランザクション/アクションの結果を取得します。
使い：	Webサイトがトランザクションの結果を取得する準備ができたときに呼び出されます。たとえば、次のようなものがあります。フェデレーション決済サービスを使用した顧客の取引の結果を取得する。
署名：	GetPaymentServiceActionResultResult GetPaymentServiceActionResult(NotNull GetPaymentServiceActionResultRequest request)
インプット：
	ロケール – 必須。マーチャントWebサイトのロケールを指定します。
	PaymentAcceptResultAccessCode – 必須です。フェデレーション決済サービスからの結果アクセスコードを指定します。このコードは通常、クロスページのJavaScriptイベントを通じて販売者のウェブサイトに送信されます。
アウトプット：
	CardToken – 顧客が支払いサービスに提供した支払い情報を表すカードトークン。
	認証結果 – 決済サービスとの取引の結果を識別する値。この文字列の形式は、使用されている支払いサービスに固有です。
	システムメッセージ - 外部システムからのメッセージの収集。

使用例:

var request = new GetPaymentServiceActionResultRequest()
{
    Locale = Context.Culture.Name,
    PaymentAcceptResultAccessCode = "accessCode"
};
var provider = (PaymentServiceProvider) Factory.CreateObject("paymentServiceProvider", true);
var result = provider.GetPaymentServiceActionResult(request);

この記事を改善するための提案がある場合は、お知らせください!