home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Create a Payment Method API approach

Create an Apple Pay Payment Method API approach (Part 2)

Learn how to configure Apple Pay for your organization, including registering merchant IDs, generating certificates, and integrating with payment gateways.

Complete the following steps to configure Apple Pay:

  1. Use your Apple Pay developer account to register merchant ID and the merchant domain for your organization. See Getting Started with Apple Pay for details.
  2. Sign up for a merchant account for a payment gateway according to your needs.

    • If you have an existing Chase Orbital gateway account, make sure it is using the Salem Platform. See Chase Paymentech (Orbital) Gateway for more information.

    • If you have an existing CyberSource payment gateway account, make sure you are also using the CyberSource, Payment API v2.0 gateway integration in Zuora. See CyberSource Payment Gateway for more information.

  3. Generate the Apple Pay certificate and send it to Zuora:
    1. Contact Zuora Global Support to generate a Certificate Signing Request file (.certSigningRequest extension) for you. Zuora Global Support will then send the CSR file to you.
    2. On the Apple Pay website, upload the CSR file, and then download the payment processing certificate.
    3. Send the payment processing certificate back to Zuora Global Support together with your Apple Pay merchant ID.
  4. You need to complete several integration steps to make Apple Pay functional on your website. For example, register and validate your website domain as described in Configuring your environment . For more information, see Implementing Apple Pay .

After you have completed the configuration, you can use the Create an Apple Pay payment method REST API operation to create an Apple Pay payment method.

After an Apple Pay payment method has been added to a customer account, it can be used to make payments similar to using credit cards. You can use Apple Pay payment methods in all Payments API operations. Recurring transactions through Apple Pay will be processed identically to credit card transactions. Processing Apple Pay transactions is not supported by the legacy CRUD API operations. You can also view the Apple Pay payment method in Zuora UI and process payments through the UI. Like other credit cards, you cannot modify the card type and card number when editing a payment method in Apple Pay.

This approach works for setting up Apple Pay on Adyen Integration v2.0.

  • Ensure that you have enabled the Apple Pay functionality for your Adyen merchant account, and built your payment form to retrieve Apple Pay tokens as described in Adyen documentation . You can use either an Adyen Apple Pay certificate or a custom Apple Pay certificate to generate an Apple Pay token. However, Zuora recommends that you take the Adyen certificate approach. If you use the Adyen Apple Pay certificate to generate an Apple Pay token, all certificate management work is done on the Adyen side, so you do not need to upload it in Zuora. However, you need to retrieve a Base64 encoded string as a response. This string should be decoded prior to being sent to Zuora. See the Apple Pay session response from Adyen documentation for details. If you use a custom Apple Pay certificate, you are responsible for the generation of the certificate and maintenance of its lifecycle. See Use your own Apple Pay certificate to complete the Apple Pay session validation from Adyen documentation for more information.

  • Ensure that an Adyen Integration v2.0 gateway instance is in active use in your Zuora tenant.

Last updated: December 3, 2025