--- title: 代替支払い方法（非クレジットカード）テスト slug: 3-xJ2BFj3f2bBpxUjkx-0 createdAt: 2025-07-30T21:22:24.109Z --- クレジットカード以外の注文には、注文の一部または全額を支払うために使用できる代替支払い方法が含まれます: - ギフトカード - ストアクレジット - ロイヤリティポイント - ApplePay - AmazonPay - AfterPay - Affirm - ShopRunner - Klarna 以下は、各支払い方法の推奨テストとマッピングの概要です。 ## ギフトカード注文 ### ギフトカードマッピング サーバーがギフトカード注文を正しく識別できるように、リクエストに支払い手段の詳細としてギフトカードを送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります: ```javascript 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(); } ``` ### ギフトカードテスト - 一般的なテスト取引：有効なテストギフトカードを使用して注文を行い、**任意のメールアドレス** - 顧客は、メールアドレス`approve@forter.com` - 顧客は、メールアドレス`decline@forter.com` - 顧客は、メールアドレス`notreviewed@forter.com` ## ストアクレジット ### ストアクレジットマッピング ストアクレジットの注文は、ギフトカードオブジェクトのフォーマットと同一のオブジェクトを使用します。リクエスト内で支払い手段の詳細としてストアクレジットを送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります: ```javascript 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 } ``` ### ストアクレジットテスト - 一般的なテスト取引：ストアクレジットを使用して注文を行い、**任意のメールアドレス** - 顧客は、メールアドレスを使用してストアクレジットで全注文を支払います`approve@forter.com` - 顧客は、メールアドレスを使用してストアクレジットで全注文を支払います`decline@forter.com` - 顧客は、メールアドレスを使用してストアクレジットで全注文を支払います`notreviewed@forter.com` ## ロイヤルティポイント ### ロイヤルティポイントのマッピング ストアクレジットの注文は、ギフトカードオブジェクトのフォーマットと同一のオブジェクトを使用します。リクエスト内でストアクレジットを支払い手段の詳細として送信してください。検証APIドキュメントには、専用のgiftCardオブジェクトの支払い配列が必要です。リクエストは次のようになります: ```javascript 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 } ``` ### ロイヤルティポイントのテスト - 一般的なテスト取引：ロイヤルティポイントを使用して注文を行い、**任意のメールアドレス** - 顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います`approve@forter.com` - 顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います`decline@forter.com` - 顧客は、メールアドレスを使用してストアのロイヤルティポイントで全注文を支払います`notreviewed@forter.com` ## ApplePay ### ApplePay マッピング ApplePay 注文はトークン化されたカードオブジェクトを利用します。リクエスト内で支払い手段の詳細として ApplePay 注文を送信してください。検証 API ドキュメント内には、payment 配列内に専用の applePay オブジェクトが必要です。リクエストは次のようになります: ```javascript 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 を使用して注文を支払い、メールアドレスは`approve@forter.com` - 顧客が ApplePay を使用して注文を支払い、メールアドレスは`decline@forter.com` - 顧客が ApplePay を使用して注文を支払い、メールアドレスは`notreviewed@forter.com` ## デジタルウォレット（例：AmazonPay、MetaPay） ### デジタルウォレットマッピング デジタルウォレットオブジェクトには、以下のいずれかの支払い方法が含まれます: - AmazonPay - AliPay - FacebookPay - MetaPay - Zelle - WeChat Pay - Mercado Pago - UnionPay - Payco - Ame Digital - KakaoPay - Line Pay - NaverPay - MB Way これらの注文はデジタルウォレットメソッドを使用します。上記のいずれかの支払い方法を `digitalWallet` オブジェクトに送信し、私たちの [Order v3](https://docs.forter.com/reference/order-v3) ドキュメントに記載されている専用の列挙型のいずれかを使用してください。 ```javascript 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 = "john_s@test.com"; // email associated with digital wallet this.fullDigitalWalletResponsePayload = {}; // full response payload from digital wallet gateway } ``` ### デジタルウォレットテスト - 一般的なテスト取引：適用可能なデジタルウォレットを使用して注文を行い、**任意のメールアドレス** - 顧客はAmazonPay（または適用可能なデジタルウォレット）とメールアドレスを使用して注文の支払いを行います`approve@forter.com` - 顧客は適用可能なデジタルウォレットとメールアドレスを使用して注文の支払いを行います`decline@forter.com` - 顧客は適用可能なデジタルウォレットとメール`notreviewed@forter.com` ## AfterPay ### AfterPay マッピング AmazonPayと同様に、AfterPayの注文は主に自由形式ですが、専用のオブジェクトであるべきinstallmentServiceメソッドオブジェクトを使用します。AfterPayの支払いデータをリクエストの`GeneralPayment`オブジェクトに支払い手段の詳細として送信してください。 ```javascript function ForterAffirm(auth) { // optional object for purchases made with Affirm this.name = "AfterPay Payment"; this.payload= {}; // any additional raw response data } ``` ### Affirm テスト - 一般的なテスト取引：AfterPayアカウントを使用して注文を行い、**任意のメールアドレス** - 顧客はAfterPayとメールアドレス`approve@forter.com`を使用して注文の支払いを行います。 - 顧客はAfterPayとメールアドレス`decline@forter.com`を使用して注文の支払いを行います。 - 顧客はAfterPayとメール`notreviewed@forter.com`を使用して注文の支払いを行います。 デフォルトでは、AfterPayの支払いは詳細な取引ビューで**一般的な支払い方法**として表示され、Forterはこれらの取引を判断しません（つまり、`未審査`の判断を返します）。AfterPayは通常、この方法での支払いに対して独自のカバレッジと詐欺検出を提供します。ただし、この支払い方法に関して判断が必要な場合は、オンボーディングアナリストにお問い合わせください。 ## アファーム ### アファームマッピング アファームの注文は、一般的な支払い方法オブジェクトを使用します。これは主に自由形式ですが、専用のオブジェクトであるべきです。リクエスト内の支払い手段の詳細として、一般的な支払いオブジェクトにアファームを送信してください。 ```javascript function ForterAffirm(auth) { // optional object for purchases made with Affirm this.name = "Affirm Payment"; this.payload= {}; // any additional raw response data } ``` ### アファームテスト - 一般的なテスト取引：AmazonPayアカウントを使用して注文を行い、**任意のメールアドレス** - 顧客はAmazonPayとメールアドレス`approve@forter.com` - 顧客はAmazonPayとメールアドレス`decline@forter.com` - 顧客はAmazonPayとメール`notreviewed@forter.com` デフォルトでは、Affirmの支払いは**一般的な支払い方法**として詳細な取引ビューに表示され、Forterはこれらの取引を判断しません（つまり、`未審査`の決定を返します）。この支払い方法に対して決定を希望する場合は、オンボーディングアナリストに連絡してください。 ## ShopRunner ### Shoprunnerマッピング ShopRunnerの注文は、既存のcreditCardオブジェクトまたはtokenizedCardオブジェクトを利用できます。利用可能な認証データに応じて、これらはリクエスト内のtokenizedCardまたはcreditCardの支払い手段の詳細にマッピングする必要があります。以下の例のリクエストはtokenizedCardマッピングを使用しています： ```javascript 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(); } ```