2月 21, 2026

決済アプリAPIで支払い詳細フィールドを公開する

2月 21, 2026

Payments Apps APIにおける支払詳細フィールドの公開

ECサイトの運営において、支払いトランザクションの精度とセキュリティの向上は重要な課題です。特に、カード非接触取引やアドレス認証システム（AVS）のレスポンスコード、カード認証値（CVV）の正確な入力による詐欺防止などが求められます。ShopifyのPayments Apps APIでは、これらの課題を解決するために新たな入力フィールドが導入されました。

具体的な技術的ソリューションの提案

Shopifyは、トランザクションの精度とセキュリティを向上させるために、以下の新たな入力フィールドをPayments Apps APIに導入しました。

cardNotPresent：カード非接触取引の詳細をキャプチャします。これにより、カードが物理的に存在しない場合の取引の精度が確保されます。
avsResultCode：アドレス認証システム（AVS）からのレスポンスコードを記録します。これにより、アドレス詳細の検証によるセキュリティが強化されます。
cvvResultCode：クレジットカード会社のレスポンスに基づいて、カード認証値（CVV）が正しく入力されたかどうかを示します。これにより、詐欺防止が改善されます。

実装手順とコード例

新たに導入されたフィールドは、Payments Apps APIのPaymentSessionPaymentDetailsオブジェクトに追加されています。これらのフィールドを使用するには、以下のようにAPIリクエストを行います。


// APIリクエストの例
{
  "paymentDetails": {
    "cardNotPresent": {
      "avsResultCode": "Y",
      "cvvResultCode": "M"
    }
  }
}

パフォーマンス・コスト分析

新たに導入されたフィールドを使用することで、支払いトランザクションの精度とセキュリティが向上します。これにより、不正取引のリスクを軽減し、カスタマーエクスペリエンスを向上させることが期待できます。また、これらのフィールドはAPIリクエスト内で直接使用できるため、追加の開発コストやパフォーマンス負荷はほとんど発生しません。