New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates

  • Release Notes

Payment Methods

  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration

  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Stripe
  • PayPal Payment Services
  • Chargebee Pay
  • Adyen
  • Authorize.net
  • Bambora (formerly Beanstream)
  • Bank of America
  • BluePay
  • BlueSnap
  • Braintree
  • Checkout.com
  • CyberSource
  • dLocal
  • EBANX
  • Ecentric
  • Elavon
  • E-xact Direct Integration
  • eWay Rapid
  • Global Payments
  • GoCardless
  • J.P. Morgan Mobility Payment Solutions
  • Metrics Global
  • Mollie
  • Moneris
  • Network Merchants Incorporated (NMI)
  • Nuvei
  • Orbital (Chase Paymentech)
  • Pay.com
  • Paymill
  • Paystack
  • Pin Payments
  • QuickBooks Payments
  • Razorpay
  • Sage Pay
  • Solidgate
  • Tempus
  • Twikey
  • Windcave
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
    • WorldPay Direct Integration
    • Worldpay US eCom
      • ACH via Worldpay US eCom
      • Apple Pay via Worldpay US eCom
      • Google Pay via Worldpay US eCom
    • Worldpay via Spreedly
  • Articles and FAQ

Level 2/3 Data Support

  • Level 2/3 Data Support

Payment Optimization Engine

  • Overview
  • Defaults
  • Advanced Setup
  • Payment Method Display Rules
  • Verification Rules
  • Routing Rules

Dunning

  • Dunning
  • Articles and FAQ

Offline Checkout

  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping

  • Transaction Sync and Invoice Mapping

Fraud Management

  • Fraud Management

Error Handling

  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs

  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Gateway Webhook Logs
  • Articles and FAQ

Others

  • Reach (Merchant of Record)
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  3. Payment Gateways and Configuration
  5. Worldpay
  7. Worldpay US eCom
  8. Apple Pay via Worldpay US eCom
  1. Payments
  3. Payment Gateways and Configuration
  5. Worldpay
  7. Worldpay US eCom
  8. Apple Pay via Worldpay US eCom

Apple Pay via Worldpay US eCom (Vantiv)

This feature is currently a Private Beta release. Contact Chargebee Support to enable Apple Pay via Worldpay US eCom (Vantiv Litle) for your live and test sites.

Introduction

Worldpay US eCom (formerly Vantiv Litle) lets you accept payments through multiple payment methods, on any device that supports Apple Pay.

You can configure your Chargebee site to accept Apple Pay using your Worldpay US eCom (Vantiv Litle) account. Apple Pay via Worldpay US eCom is supported by Chargebee's API, hosted pages, and Chargebee JS.

Note

Apple Pay in Chargebee can be enabled for only one payment gateway at a time. Make sure you disable it from any other gateway to enable it for your desired gateway.

Integration options

Apple Pay via Worldpay US eCom (Vantiv Litle) is supported across the following Chargebee integration options:

Integration methodDescriptionSupported
Chargebee APIIntegrate directly with the Chargebee API to accept Apple Pay payments.Yes
Chargebee hosted pagesAccept Apple Pay through Chargebee's hosted checkout pages.Yes
Chargebee JSBuild a custom checkout that accepts Apple Pay using Chargebee JS.Yes

Prerequisites

  • Configure your Worldpay US eCom (Vantiv Litle) payment gateway in Chargebee. If already configured, move to the next step.
  • Set up Apple Pay in your Apple Developer account and prepare the required files before integrating Apple Pay in Chargebee.

Configuring Apple Pay

Follow these steps to configure your Chargebee account to accept Apple Pay payments via Worldpay US eCom (Vantiv Litle):

  1. Click Settings > Configure Chargebee > Payment Gateway > Worldpay US eCom (Vantiv Litle).
  2. Enable Apple Pay.
    Enable Apple Pay toggle on the Configure Vantiv Litle payment methods page
  3. Enter your Business Name.
  4. Enter your Merchant ID. Follow these steps to learn how to create or retrieve your Merchant ID.
  5. Select the Merchant Country Code. This is the country or the region where the payment will be processed.
  6. Upload your Merchant Identity Certificate (.pem) and Merchant Identity Key (.key). Follow these steps to learn how to create or retrieve these files.
  7. Upload your Domain Association File (.txt). Follow these steps to learn how to get this file.
  8. Upload your Apple Pay Payment Processing Certificate (.pem). Follow these steps to learn how to create or retrieve this file.
  9. Upload your Apple Pay Payment Processing Key (.key). Follow these steps to learn how to create or retrieve this file.
  10. Under Choose mandatory information to collect from customers, select one or multiple options—Shipping Address, Billing Address, or Email and Phone—if you want to collect this information mandatorily from customers. You can copy these mandatory details for customers from Apple Pay, if already available.
    Apple Pay configuration form for Worldpay US eCom (Vantiv)
  11. Click Save to complete the configuration.

Note

Unlike some other gateways, Worldpay US eCom (Vantiv Litle) requires you to upload the Apple Pay Payment Processing Certificate (.pem) and Apple Pay Payment Processing Key (.key) directly in this form before you click Save.

Configure Smart Routing

When you enable Apple Pay via Worldpay US eCom (Vantiv Litle), configure Smart Routing to set it as the preferred gateway for Apple Pay. If another gateway is already configured for Apple Pay, you can update the routing preferences on the Smart Routing page.

Follow these steps to modify the Smart Routing settings:

  1. In your Chargebee Billing site, go to Settings > Configure Chargebee > Payment Gateways.
  2. Click Manage Rules under Smart Routing.
    Manage Rules under Smart Routing
  3. Go to the Apple Pay section and click Add a Gateway (or the Edit icon) for the relevant currency.
    Apple Pay section in Smart Routing rules
  4. From the Choose a payment gateway dropdown, select the Worldpay US eCom (Vantiv Litle) gateway instance from your Chargebee site with Apple Pay enabled.
  5. Click Save.
    Choose a payment gateway dialog with Save

Note

The domain validation requirements of Apple Pay restrict the configuration to only one payment gateway that can actively support Apple Pay at a time. Therefore, the option to enable Apple Pay via other payment gateways such as Stripe or Braintree must be disabled.

Payment workflow

The following steps are involved in the customer's payment flow when they select Apple Pay using Chargebee's checkout:

  1. Click Proceed to Checkout from the Your Order page to initiate a purchase.
    Proceed to Checkout on the Your Order page
  2. Click the Apple Pay button.
    Apple Pay button
  3. The Apple Pay sheet appears. The customer authenticates with Face ID, Touch ID, or their passcode and selects a card to complete the payment.
    Apple Pay payment sheet
  4. Once the payment is made, the customer is redirected to Chargebee and the payment method is successfully linked to the customer. Recurring payments are made using the selected card in Apple Pay.

Payment features

The following are the features for this integration and details about them:

FeatureDescriptionSupportedDefault stateConfiguration / behavior
Integration sync modeDefines how payment requests are processed and statuses are communicated between Chargebee and Worldpay US eCom.Yes (Synchronous)SynchronousWorldpay US eCom processes Apple Pay payments synchronously. Chargebee receives the payment status in the gateway response.
Capture settingsPayment processing involves two stages: Authorization and Capture. Capture settings determine when funds are collected after authorization.YesAuto captureAuto capture is the default and only supported capture setting for Worldpay US eCom. No additional configuration is required.
Verification modesDefines how payment methods are verified before processing.YesEnabledThe Apple Pay token is verified during payment processing. No additional configuration is required.
Statement descriptorDisplays the business name on the customer's bank or card statement, helping them recognize charges and reducing disputes.YesDisabledConfigure this under Settings > Configure Chargebee > Transaction Descriptor.
Chargeback managementHandles chargeback events and applies configured actions on invoices and subscriptions.YesDisabledEnable Chargeback Management under Settings > Configure Chargebee > Billing LogIQ > Payments > Chargeback Management.
Fraud managementUses gateway fraud signals to identify and flag high-risk transactions.NoNANo Apple Pay-specific fraud configuration is available in Chargebee.
Transaction initiation typeIdentifies whether a transaction is customer-initiated (CIT) or merchant-initiated (MIT).YesSupportedThe initial payment is customer-initiated through the Apple Pay wallet. Subsequent recurring payments are merchant-initiated.
Error intelligenceProvides standardized categorization of payment failures.YesEnabledAvailable via Worldpay US eCom response codes. No configuration is required.
Gateway transaction detailsProvides access to raw gateway responses for transactions.YesEnabledAvailable on the transaction page under Error details. No configuration is required.
Addition of payment methods in Chargebee dashboardAllows a payment method to be added in Chargebee when details are collected outside the platform.NoNAApple Pay requires customer authorization through the wallet and cannot be added through the Chargebee dashboard.

Supported token formats

This section is relevant if you are building a custom checkout or migrating payment methods from another provider to Worldpay US eCom.

Token typeDescriptionSupportedToken fieldToken format
Chargebee Payment IntentRecommended token format when building a custom checkout using Chargebee JS.Yespayment_intent[id]payment_intent_id
Chargebee tokenLegacy token format supported for selected payment methods and gateways with Chargebee JS. Not recommended for new implementations.Notoken_idNA
Gateway permanent tokenPermanent reference provided by the gateway and used for future recurring payments or migrations from another PSP.Yespayment_method[reference_id]customer_id/payment_source_id

Testing

Testing in sandbox

Use your Worldpay US eCom (Vantiv Litle) Pre-live account linked to your Chargebee test site to validate the Apple Pay integration before going live.

  • Apple Pay is available only on iOS devices or the Safari browser on macOS. Run your tests on a supported device.
  • Add a card to Apple Wallet on the test device, then complete a test checkout to validate the end-to-end flow.

Testing in production

Before moving to live:

  • Ensure Apple Pay is fully configured in Worldpay US eCom (Vantiv Litle) and Chargebee.
  • Perform end-to-end testing using a real card to validate the complete payment flow.

Was this article helpful?