Save a Venmo payment method for future billing
Learn how to save a customer's Venmo payment method for future subscription billing without making an initial purchase.
- Your Zuora tenant is configured to use the PayPal Complete Payments (PPCP) gateway integration with Venmo.
- You have integrated the Zuora payment SDK and are able to create Hosted Payment Method (HPM) sessions.
- The customer account is set up and ready to receive a stored payment method.
The vault-without-purchase flow lets you save a customer's Venmo payment method for recurring or subscription billing without charging the customer at the time of enrollment. This supports use cases such as free trials and free subscriptions where you need a payment method on file before any charge occurs.
In this flow, Zuora creates a Venmo setup token, prompts the customer to approve the vault relationship through their Venmo account, exchanges the approved setup token for a permanent payment token, and stores the payment method in Zuora. No payment is created. If the customer cancels or declines the approval, no active payment method is stored.
The following fields are stored on the payment method record when the flow completes successfully: VaultId, CustomerId, EmailId, and VenmoAccountId.
processPayment and storePaymentMethod parameters cannot both be set to false in the same HPM session. The API returns an error if both are false.The customer's Venmo payment method is saved to their Zuora account and is available for future subscription charges. The stored payment method record includes the VaultId, CustomerId, EmailId, and VenmoAccountId fields. No payment transaction is created during this flow.
If the customer cancels or declines the Venmo approval, no active payment method is stored and no payment is created. You can present the enrollment flow again if the customer chooses to retry.