You can now accept Venmo through your Braintree Payments gateway in Sticky.io. Venmo is a digital wallet payment, so the customer authorizes it in Venmo on your checkout page. Your page then sends Sticky.io a one-time payment nonce, and Sticky.io handles the rest.
1. Enable Venmo in your Braintree account
Venmo is turned on in the Braintree Control Panel, not in Sticky.io. Your Braintree Payments gateway profile in Sticky.io stays the same.
Sandbox (for testing):
Log in to the Braintree sandbox Control Panel.
Click the gear icon, then Account Settings.
In the Payment Methods section, click Options next to Venmo.
4. Click Accept to accept Venmo's terms.
Production:
Log in to the Braintree production Control Panel.
Click the gear icon, then Processing.
In the Payment Methods section, click Enable next to Venmo.
4. Create a Venmo profile: business display name, business image, contact phone, email or URL, and anticipated annual Venmo volume. Click Save.
5. Braintree reviews the application and enables Venmo for your production account when it is approved.
Eligibility is set by Braintree. You need a US business entity, and you must use the Braintree JavaScript v3, Android v5 or iOS v6 SDK. In-person sales, getting paid through the Venmo app, and peer-to-peer transfers are not supported. See Braintree's Venmo availability requirements.
2. Add the Venmo button to your checkout page
Recommended: Braintree JavaScript SDK v3 (Venmo component)
Use Braintree's `venmo` component to build your own Venmo button. This is the option Braintree recommends going forward. Load the client and Venmo components (current version at the time of writing: 3.148.0; check Braintree's installation guide:
```html
<script src="https://js.braintreegateway.com/web/3.148.0/js/client.min.js"></script>
<script src="https://js.braintreegateway.com/web/3.148.0/js/venmo.min.js"></script>
<button id="venmo-button" style="display:none">Pay with Venmo</button>
```
```javascript
var venmoButton = document.getElementById('venmo-button');
braintree.client.create({
authorization: 'CLIENT_AUTHORIZATION' // tokenization key or client token from Braintree
}, function (clientErr, clientInstance) {
if (clientErr) { return console.error(clientErr); }
braintree.venmo.create({
client: clientInstance,
allowDesktop: true, // desktop: show a QR code to scan with the Venmo app
mobileWebFallBack: true, // mobile without the Venmo app: web login
paymentMethodUsage: 'multi_use' // lets the Venmo account be vaulted for future payments
}, function (venmoErr, venmoInstance) {
if (venmoErr) { return console.error(venmoErr); }
// Only show the button if the browser supports Venmo.
if (!venmoInstance.isBrowserSupported()) { return; }
venmoButton.style.display = 'block';
// If your checkout reopens in a new tab after the Venmo app, finish there.
if (venmoInstance.hasTokenizationResult()) {
venmoInstance.tokenize(function (err, payload) {
if (!err) { sendNonceToCheckout(payload.nonce); }
});
return;
}
venmoButton.addEventListener('click', function () {
venmoButton.disabled = true;
venmoInstance.tokenize(function (tokenizeErr, payload) {
venmoButton.disabled = false;
if (tokenizeErr) { return console.error(tokenizeErr.code, tokenizeErr.message); }
// payload.nonce is the one-time Venmo nonce.
// Send it to sticky.io as braintree_nonce (see step 3).
sendNonceToCheckout(payload.nonce);
});
});
});
});
```
`sendNonceToCheckout` is your own function, for example one that puts the nonce in a hidden form field. If your checkout page can't reopen in a new tab, add `allowNewBrowserTab: false` to `braintree.venmo.create`. Braintree requires custom Venmo buttons to show the customer an order summary before and after purchase and to follow Venmo's brand guidelines, so read the Client-Side Implementation guide before you go live.
Quick option: Drop-in UI
Braintree's Drop-in UI renders the Venmo option for you with only a `venmo` setting:
```html
<script src="https://js.braintreegateway.com/web/dropin/1.44.1/js/dropin.min.js"></script>
<div id="dropin-container"></div>
<button id="submit-button">Pay</button>
<script>
braintree.dropin.create({
authorization: 'CLIENT_AUTHORIZATION',
container: '#dropin-container',
venmo: {
// Optional. Only show Venmo on browsers that don't need a new tab/page reload.
allowNewBrowserTab: false
}
}, function (createErr, instance) {
document.getElementById('submit-button').addEventListener('click', function () {
instance.requestPaymentMethod(function (err, payload) {
if (err) { return console.error(err); }
// payload.nonce is the one-time Venmo nonce -> send to sticky.io as braintree_nonce.
});
});
});
</script>
```
*NOTE:* Braintree is deprecating Drop-in. No new features or fixes will be released after October 1, 2026, payment processing is supported until October 1, 2027, and Braintree recommends migrating to the Braintree JavaScript SDK. For new builds, use the JavaScript SDK above. See Braintree's Drop-in setup page.
If a customer's browser doesn't support Venmo, the Venmo option isn't shown. Venmo can't run inside an iframe.
Mobile apps
- iOS SDK (v6): iOS guide.
- Android SDK (v5): Android guide.
All options return a one-time payment method nonce.
3. Send the nonce to Sticky.io in the New Order request
When the customer completes Venmo, send the nonce in your Sticky.io API New Order request by including the following fields:
creditCardType=venmo,
braintree_nonce:<nonce from Braintree>
Include the usual New Order fields as well (customer name, address, campaign, product, and so on). A Venmo order without a nonce is declined with "Venmo payment nonce is required."
4. Subscriptions and rebills
A Venmo nonce can only be used once. When Sticky.io receives it, Sticky.io exchanges it with Braintree for a permanent (vaulted) Venmo payment method. Sticky.io saves that vaulted payment method on the order and uses it for later subscription and rebill charges, so the customer doesn't have to approve Venmo again.
If Braintree can't vault the Venmo payment method, recurring and $0 trial orders are declined, because a rebill would have no reusable payment method.
NOTES:
- Venmo is available only for US business entities (see Braintree's requirements in step 1).
- Nonces are single-use. Request a new nonce for each attempt, for example if a customer retries after a decline.
- To test in the sandbox, use the Braintree sandbox Control Panel (step 1) and the sandbox keys in a test-mode Braintree Payments gateway. Braintree's test nonce is `fake-venmo-account-nonce`. In the sandbox, the Venmo flow always returns a test user (VenmoJoe), and purchases don't show in the Venmo app. See Venmo testing and go live.
- Venmo refunds must be issued within 180 days of the original sale (Braintree requirement).
