Pay with Venmo integration
Last updated: Oct 31st, 9:19am
Add the Venmo button to your Checkout integration.
Know before you code
- This integration is available to select partners only.
- Complete Onboard merchants before you begin this integration.
- You must have an access token.
- To run test transactions, set
client-id
to your sandbox client ID. - Complete a PayPal Checkout integration.
Test and go live
Note: Venmo is available in the US only. To simulate the Venmo button in the PayPal Sandbox, add the buyer-country=US
parameter to your JS SDK code.
Pay with Venmo is a mobile experience, so be sure to have the Venmo iOS or Android app installed and test on an iOS Safari or Android Chrome browser.
Use your live login information during the checkout flow to complete a Venmo transaction. Then, log into PayPal.com to see the money move out of your account.
When making a test purchase, note that:
- The Venmo app must be installed.
- The business account receiving money can’t also make the purchase.
- The personal account may have restrictions if you create the personal account with the same information as the business account.
To test a purchase:
- Open your test page with iOS Safari or Android Chrome.
- Tap the Venmo button and switch to the Venmo app.
- On the Venmo app, tap Continue or Pay Now to return to your test page.
- If you have an additional confirmation page on your website, confirm the payment.
- Log in to your business account and confirm that the money you used to pay moved into that account.
Troubleshoot your integration
Confirm that there are no browser console warnings or errors. The JavaScript SDK configuration attributes have validation checks for input formatting and values.
If the validation fails, the web browser’s developer console displays warning messages that inform you which property isn't valid. The library reverts to the safe default values if the properties aren't valid.
Best practices
Enable Venmo as a funding source
Venmo isn't displayed as a payment option in Checkout integrations by default. Add enable-funding=venmo
as a query parameter to your JavaScript SDK <script>
to display Venmo as a payment option. For more information, see enable funding.
Allow for Venmo placement
If you have an existing vertical button stack, an additional Venmo button renders under the stack. Make sure you leave enough room on your page for the Venmo button.
Display funding source used
If you have a confirmation page or a notification to the user that shows the funding source that was used, use an onClick
handler to display Venmo in the confirmation notification.
1let fundingSource23paypal.Buttons({4 onClick: (data) => {5 // fundingSource = "venmo"6 fundingSource = data.fundingSource78 // Use this value to determine what funding source was used to pay9 // Update your confirmation pages and notifications from "PayPal" to "Venmo"10 },11})