Flutter WebView集成PayPal V2 Orders API时CVV验证失效问题

针对你在Flutter WebView集成PayPal V2 Orders API时遇到的无效CVV仍能完成交易的问题，可通过以下步骤强制启用有效的CVV验证：

1. 订单创建时显式指定CVV验证要求 #

创建订单（POST /v2/checkout/orders）的请求中，需在payment_source.card节点下添加验证规则，明确要求CVV校验：

{
  "intent": "CAPTURE",
  "purchase_units": [
    {
      "amount": {
        "currency_code": "USD",
        "value": "10.00"
      }
    }
  ],
  "payment_source": {
    "card": {
      "number": "4111111111111111",
      "expiry": "12/28",
      "cvv": "123",
      "name": "John Doe",
      "billing_address": {
        "address_line_1": "123 Main St",
        "admin_area_2": "San Jose",
        "admin_area_1": "CA",
        "postal_code": "95131",
        "country_code": "US"
      },
      "verification": {
        "cvv": "REQUIRED"
      }
    }
  }
}

如果是通过WebView加载PayPal JS SDK初始化订单，需在createOrder回调中加入上述verification配置。

2. 检查WebView中PayPal JS SDK的初始化参数 #

若使用PayPal官方JS按钮组件，初始化时需确保配置了强制CVV验证：

paypal.Buttons({
  createOrder: function(data, actions) {
    return actions.order.create({
      intent: 'CAPTURE',
      purchase_units: [{/* 订单金额配置 */}],
      payment_source: {
        card: {
          verification: {
            cvv: 'REQUIRED'
          }
        }
      }
    });
  },
  onApprove: function(data, actions) {
    return actions.order.capture().then(function(details) {
      // 后续业务处理
    });
  }
}).render('#paypal-button-container');

3. 确认商户账户的验证设置 #

• 生产环境：登录PayPal商户后台，进入【付款设置】>【网站付款】>【更新】，开启"CVV验证"选项。
• 沙箱环境：对应沙箱商户账户需同步开启相同设置，路径与生产后台一致。

4. 使用标准测试卡进行验证 #

沙箱环境中避免使用PayPal提供的"跳过验证"测试卡，改用标准测试卡测试：

• Visa标准测试卡：4111111111111111，有效CVV为123，输入其他值（如456）应触发验证失败。

5. 捕获订单时校验验证状态 #

调用POST /v2/checkout/orders/{order_id}/capture后，不要仅依赖order.status判断结果，需检查payment_source.card.verification_status字段：

• 验证通过：SUCCESS
• CVV无效：FAILURE
  即使订单状态为COMPLETED，若该字段为FAILURE，需在业务逻辑中拒绝交易。示例响应片段：

{
  "id": "O-XXXXXX",
  "status": "COMPLETED",
  "payment_source": {
    "card": {
      "verification_status": "FAILURE",
      "brand": "VISA"
    }
  }
}

内容的提问来源于stack exchange，提问作者Khyati Kasundra