代替支払い方法（非クレジットカード）テスト

クレジットカード以外の注文には、注文の一部または全額を支払うために使用できる代替支払い方法が含まれます:

ギフトカード
ストアクレジット
ロイヤリティポイント
ApplePay
AmazonPay
AfterPay
Affirm
ShopRunner
Klarna

以下は、各支払い方法の推奨テストとマッピングの概要です。

ギフトカード注文

ギフトカードマッピング

サーバーがギフトカード注文を正しく識別できるように、リクエストに支払い手段の詳細としてギフトカードを送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります:

function ForterGiftCard(auth, gc) { // optional object for gift card purchases
	this.merchantPaymentId = gc.paymentTransaction.transactionID;
	this.value = {};
	this.value.currency = auth.currency_code;
	this.value.amountUSD = auth.amount.toString();
	this.value.amountLocalCurrency = auth.amount.toString();
}

ギフトカードテスト

一般的なテスト取引：有効なテストギフトカードを使用して注文を行い、任意のメールアドレス
顧客は、メールアドレス[email protected]
顧客は、メールアドレス[email protected]
顧客は、メールアドレス[email protected]

ストアクレジット

ストアクレジットマッピング

ストアクレジットの注文は、ギフトカードオブジェクトのフォーマットと同一のオブジェクトを使用します。リクエスト内で支払い手段の詳細としてストアクレジットを送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります:

function ForterStoreCredit(auth, sc) { // optional object for purchases made with store credit 
	this.merchantPaymentId = sc.paymentTransaction.transactionID; // customized based on gateway
	this.value = {};
	this.value.currency = auth.currency_code; // customized based on gateway
	this.value.amountUSD = auth.amount.toString(); // customized based on gateway
	this.value.amountLocalCurrency = auth.amount.toString(); // customized based on gateway
}

ストアクレジットテスト

一般的なテスト取引：ストアクレジットを使用して注文を行い、任意のメールアドレス
顧客は、メールアドレスを使用してストアクレジットで全注文を支払います[email protected]
顧客は、メールアドレスを使用してストアクレジットで全注文を支払います[email protected]
顧客は、メールアドレスを使用してストアクレジットで全注文を支払います[email protected]

ロイヤルティポイント

ロイヤルティポイントのマッピング

ストアクレジットの注文は、ギフトカードオブジェクトのフォーマットと同一のオブジェクトを使用します。リクエスト内でストアクレジットを支払い手段の詳細として送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります:

function ForterLoyalty(auth, loyalty) { // optional object for purchases made with loyalty points
	this.loyaltyPointsCount = sc.paymentTransaction.loyaltyValue; // customized based on gateway
	this.loyaltyPointsSource = account.pointsLocation; // optional
	this.merchantPaymentId = auth.loayltyCode; // optional
}

ロイヤルティポイントのテスト

一般的なテスト取引：ロイヤルティポイントを使用して注文を行い、任意のメールアドレス
顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います[email protected]
顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います[email protected]
顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います[email protected]

ApplePay

ApplePay マッピング

ApplePay 注文はトークン化されたカードオブジェクトを利用します。リクエスト内で支払い手段の詳細として ApplePay 注文を送信してください。検証 API ドキュメント内には、payment 配列内に専用の applePay オブジェクトが必要です。リクエストは次のようになります:

function ForterApplePay(auth, ap) {
// where var ap is the raw applepay response data from your payment gateway 
    var processorResponseCode = "",
        processorResponseText = "";

    // format the expiration month. from 1 to 01, etc.
    if (ap.creditCardExpirationMonth.toString().length == 1) {
        var creditCardExpMonth = "0" + cc.creditCardExpirationMonth.toString();
    } else {
        var creditCardExpMonth = cc.creditCardExpirationMonth.toString();
    }

    this.nameOnCard = ap.creditCardHolder;
    this.cardBrand = ap.creditCardType;
    this.token = ap.token;
    this.lastFourDigits = ap.creditCardNumberLastDigits; //optional
    this.expirationMonth = creditCardExpMonth;
    this.expirationYear = cc.creditCardExpirationYear.toString();

    this.verificationResults = {};
    this.verificationResults.avsFullResult = auth.avs.toString(); // optional
    this.verificationResults.cvvResult = auth.cvd_code.toString(); // optional
    this.verificationResults.authorizationCode = auth.authorization_num.toString();
    
	processorResponseCode = auth.exact_resp_code.toString();
	processorResponseText = auth.exact_message.toString();

    this.verificationResults.processorResponseCode = processorResponseCode;
    this.verificationResults.processorResponseText = processorResponseText; 
}

ApplePay テスト

一般的なテスト取引: ApplePay を使用して注文を行い、任意のメールアドレス
顧客が ApplePay を使用して注文を支払い、メールアドレスは[email protected]
顧客が ApplePay を使用して注文を支払い、メールアドレスは[email protected]
顧客が ApplePay を使用して注文を支払い、メールアドレスは[email protected]

デジタルウォレット（例：AmazonPay、MetaPay）

デジタルウォレットマッピング

デジタルウォレットオブジェクトには、以下のいずれかの支払い方法が含まれます:

AmazonPay
AliPay
FacebookPay
MetaPay
Zelle
WeChat Pay
Mercado Pago
UnionPay
Payco
Ame Digital
KakaoPay
Line Pay
NaverPay
MB Way

これらの注文はデジタルウォレットメソッドを使用します。上記のいずれかの支払い方法を digitalWallet オブジェクトに送信し、私たちの Order v3 ドキュメントに記載されている専用の列挙型のいずれかを使用してください。

    function ForterDigitalWallet(auth) { 
        this.digitalWalletName = "AMAZONPAY"; // select "AMAZONPAY" enum
        this.underlyingPaymentMethod.underlyingPaymentMethodName = "CREDITCARD"; // select from relevant enum UNKNOWN, CREDITCARD, BANKTRANSFER, CASH, BITCOIN
        this.paymentSuccessStatus = "Completed"; // gateway auth response
        this.digitalWalletPayerEmail = "[email protected]"; // email associated with digital wallet
        this.fullDigitalWalletResponsePayload = {}; // full response payload from digital wallet gateway
    }

デジタルウォレットテスト

一般的なテスト取引：適用可能なデジタルウォレットを使用して注文を行い、任意のメールアドレス
顧客はAmazonPay（または適用可能なデジタルウォレット）とメールアドレスを使用して注文の支払いを行います[email protected]
顧客は適用可能なデジタルウォレットとメールアドレスを使用して注文の支払いを行います[email protected]
顧客は適用可能なデジタルウォレットとメール[email protected]

AfterPay

AfterPay マッピング

AmazonPayと同様に、AfterPayの注文は主に自由形式ですが、専用のオブジェクトであるべきinstallmentServiceメソッドオブジェクトを使用します。AfterPayの支払いデータをリクエストのGeneralPaymentオブジェクトに支払い手段の詳細として送信してください。

    function ForterAffirm(auth) { // optional object for purchases made with Affirm
        this.name = "AfterPay Payment";
        this.payload= {}; // any additional raw response data 
    }

Affirm テスト

一般的なテスト取引：AfterPayアカウントを使用して注文を行い、任意のメールアドレス
顧客はAfterPayとメールアドレス[email protected]を使用して注文の支払いを行います。
顧客はAfterPayとメールアドレス[email protected]を使用して注文の支払いを行います。
顧客はAfterPayとメール[email protected]を使用して注文の支払いを行います。

デフォルトでは、AfterPayの支払いは詳細な取引ビューで一般的な支払い方法として表示され、Forterはこれらの取引を判断しません（つまり、未審査の判断を返します）。AfterPayは通常、この方法での支払いに対して独自のカバレッジと詐欺検出を提供します。ただし、この支払い方法に関して判断が必要な場合は、オンボーディングアナリストにお問い合わせください。

アファーム

アファームマッピング

アファームの注文は、一般的な支払い方法オブジェクトを使用します。これは主に自由形式ですが、専用のオブジェクトであるべきです。リクエスト内の支払い手段の詳細として、一般的な支払いオブジェクトにアファームを送信してください。

    function ForterAffirm(auth) { // optional object for purchases made with Affirm
        this.name = "Affirm Payment"; 
        this.payload= {}; // any additional raw response data 
    }

アファームテスト

一般的なテスト取引：AmazonPayアカウントを使用して注文を行い、任意のメールアドレス
顧客はAmazonPayとメールアドレス[email protected]
顧客はAmazonPayとメールアドレス[email protected]
顧客はAmazonPayとメール[email protected]

デフォルトでは、Affirmの支払いは一般的な支払い方法として詳細な取引ビューに表示され、Forterはこれらの取引を判断しません（つまり、未審査の決定を返します）。この支払い方法に対して決定を希望する場合は、オンボーディングアナリストに連絡してください。

ShopRunner

Shoprunnerマッピング

ShopRunnerの注文は、既存のcreditCardオブジェクトまたはtokenizedCardオブジェクトを利用できます。利用可能な認証データに応じて、これらはリクエスト内のtokenizedCardまたはcreditCardの支払い手段の詳細にマッピングする必要があります。以下の例のリクエストはtokenizedCardマッピングを使用しています：

function ShopRunner(auth, cc) {
// where var ap is the raw applepay response data from your payment gateway 
    var processorResponseCode = "",
        processorResponseText = "";

    // format the expiration month. from 1 to 01, etc.
    if (ap.creditCardExpirationMonth.toString().length == 1) {
        var creditCardExpMonth = "0" + cc.creditCardExpirationMonth.toString();
    } else {
        var creditCardExpMonth = cc.creditCardExpirationMonth.toString();
    }

    this.nameOnCard = cc.creditCardHolder;
    this.cardBrand = cc.creditCardType;
    this.token = cc.token;
    this.lastFourDigits = cc.creditCardNumberLastDigits; 
    this.expirationMonth = cc.creditCardExpMonth;
    this.expirationYear = cc.creditCardExpirationYear.toString();

    this.verificationResults = {};
    this.verificationResults.avsFullResult = auth.avs.toString(); // optional
    this.verificationResults.cvvResult = auth.cvd_code.toString(); // optional
    this.verificationResults.authorizationCode = auth.authorization_num.toString();
    
	processorResponseCode = auth.exact_resp_code.toString();
    processorResponseText = auth.exact_message.toString();
    
    this.verificationResults.processorResponseCode = processorResponseCode;
    this.verificationResults.processorResponseText = processorResponseText; 

    this.paymentGatewayData = {};
    this.paymentGatewayData.gatewayName = "FIRSTDATA_CREDIT"; // adjust based on your processor
    this.paymentGatewayData.gatewayTransactionId = auth.retrieval_ref_no.toString();
}