Skip to main content

Venmo and PayPal are now treated as separate payment methods

Starting in API version 2026-01, Venmo and PayPal are treated as separate payment methods when using payment customization functions. Previously, hiding PayPal's express checkout placement would automatically hide Venmo as well. With this change, you can now hide or show Venmo independently from PayPal in your payment customization logic.

Action required

If you were previously hiding PayPal's accelerated checkout placement to also hide Venmo, you must now explicitly hide Venmo separately in your payment customization function.

Previous behavior (automatic):

export function run(input) {
  const operations = [];

  const paypal = input.paymentMethods.find(method =>
    method.name.includes("PayPal")
  );

  if (paypal && shouldHidePayPal(input)) {
    operations.push({
      paymentMethodHide: { paymentMethodId: paypal.id }
    });
    // Venmo was implicitly hidden
  }

  return { operations };
  
}

New behavior (explicit control required):

  • Hiding PayPal's ACCELERATED_CHECKOUT placement only hides PayPal.
  • To hide Venmo, you must now explicitly hide Venmo's placement separately. Venmo is only available in the ACCELERATED_CHECKOUT placement.

To maintain the previous behavior of hiding both PayPal and Venmo together, update your payment customization function logic to explicitly target the Venmo payment method. Venmo can be targeted by checking for the exact string "Venmo" in the payment method's name field.

export function run(input) {
  const operations = [];

  const paypal = input.paymentMethods.find(method =>
    method.name.includes("PayPal")
  );

  const venmo = input.paymentMethods.find(method =>
    method.name === "Venmo"
  );

  if (shouldHidePayPal(input)) {
    if (paypal) {
      operations.push({
        paymentMethodHide: { paymentMethodId: paypal.id }
      });
    }

    // NEW: Must explicitly hide Venmo if you want both hidden
    if (venmo) {
      operations.push({
        paymentMethodHide: { paymentMethodId: venmo.id }
      });
    }
  }

  return { operations };
}
Was this section helpful?