Pay with Venmo integration

CURRENTDocs

Last updated: Mar 6th, 6:07am

Add the Venmo button to your Checkout integration.

Know before you code

If you are a new merchant, sign up for a PayPal business account.

Complete Get started to set up your PayPal account, client ID, and sandbox emails for testing.

Complete a PayPal Checkout integration.

Add Venmo button

Add the JavaScript SDK code to display the Venmo button on your product and checkout pages.
Determine where the SDK should render the Venmo button. Use button options to control the layout of the button.

1<!-- Set up a container element for the button -->
2<div id="paypal-button-container"></div>
3
4<!-- Include the PayPal JavaScript SDK. Replace `YOUR_CLIENT_ID` with your client ID.-->
5<!-- Note that `enable-funding=venmo` is added as a query parameter -->
6<script src="https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID&enable-funding=venmo"></script>
7
8<script>
9  // Render the Venmo button into #paypal-button-container
10  paypal.Buttons().render('#paypal-button-container')
11</script>

Step result

Test and go live

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 ensure you have the Venmo iOS or Android app installed. You can test this feature on an iOS Safari or Android Chrome browser.

In the sandbox environment, you can test your integration without moving any money. For more information on testing Venmo, see Test Venmo in sandbox.

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.

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 fundingSource
2
3paypal.Buttons({
4  onClick: (data) => {
5    // fundingSource = "venmo"
6    fundingSource = data.fundingSource
7
8    // Use this value to determine what funding source was used to pay
9    // Update your confirmation pages and notifications from "PayPal" to "Venmo"
10  },
11})