{"title":"PayPal and Venmo","category":"default","creationDate":1791457010,"content":"<p>PayPal or Venmo point-of-sale payments work in the same way as other <a href=\"\/point-of-sale\/qr-code-wallets\">QR code wallet payments<\/a> at the point of sale. However, a special onboarding flow applies, and you can test your integration using a test app provided by PayPal.<\/p>\n<h2 id=\"onboarding-paypal\">Onboard with PayPal\/Venmo<\/h2>\n<p>To enable point-of-sale PayPal or Venmo transactions through Adyen, you need to have PayPal sandbox and business accounts exclusively for Adyen point of sale. We then need to configure settings for you, both on your PayPal accounts and on the Adyen side.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>You cannot use a PayPal account that you may already have for online payments or for an integration with another payment services provider.<\/p>\n<\/div><\/div>\n<ol>\n<li>\n<p>Create a PayPal developer account, if you do not have one already.<\/p>\n<ul>\n<li>\n<p>Go to <a href=\"https:\/\/developer.paypal.com\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/developer.paypal.com<\/a> and select <span translate=\"no\"><strong>Log in to Dashboard<\/strong><\/span> &gt; <span translate=\"no\"><strong>Sign up<\/strong><\/span>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Create PayPal sandbox user accounts exclusively for Adyen point of sale. You need these accounts for testing.<\/p>\n<ol>\n<li>Go to <a href=\"https:\/\/developer.paypal.com\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/developer.paypal.com<\/a> and log in with your developer account.<\/li>\n<li>\n<p>Create a <span translate=\"no\"><strong>Business<\/strong><\/span> and a <span translate=\"no\"><strong>Personal<\/strong><\/span> sandbox account.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>Create a PayPal business account for Adyen point of sale. You need this account for making live payments.<\/p>\n<ul>\n<li>\n<p>Go to <a href=\"https:\/\/www.paypal.com\/us\/business\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">https:\/\/www.paypal.com\/us\/business<\/a> and select <span translate=\"no\"><strong>Sign up<\/strong><\/span>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Ask your Adyen account manager to set up your accounts for PayPal and\/or Venmo.<br \/>\nYou will receive a link to a location where you can confirm you give us permission to configure your PayPal account. We can then add the stores under your Adyen merchant account to your PayPal account.<\/p>\n<\/li>\n<\/ol>\n<h2>Implement a payment flow<\/h2>\n<p>For PayPal and Venmo we support all <a href=\"\/point-of-sale\/qr-code-wallets#qr-code-payment-flows\">QR code payment flows<\/a>:<\/p>\n<ul>\n<li>Merchant-presented from terminal: you launch the QR code from the terminal.<\/li>\n<li>Merchant-presented from POS app: you launch the QR code through your payment request.<\/li>\n<li>Consumer-presented: you scan the QR code that the shopper launched on their phone.<\/li>\n<\/ul>\n<h3>Merchant-presented from terminal<\/h3>\n<p>To launch a PayPal or Venmo QR code from the terminal:<\/p>\n<ol>\n<li>Initiate a payment.<\/li>\n<li>On the terminal, select <strong>Wallets<\/strong> and then either PayPal or Venmo.<\/li>\n<li>Hand the terminal to the shopper, so they can scan the QR code with their mobile phone and verify the payment.<\/li>\n<li>You receive the result of the payment, as you would <a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment#payment-response\">receive the result of a card payment<\/a>.<\/li>\n<\/ol>\n<p>Refer to <a href=\"\/point-of-sale\/qr-code-wallets#initiate-from-terminal\">Initiate from terminal<\/a> for a general description of this flow.<\/p>\n<h3>Merchant-presented from POS app<\/h3>\n<p>To launch a PayPal or Venmo QR code directly instead of by manually selecting options on the terminal:<\/p>\n<ol>\n<li>\n<p><a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment#make-a-payment\">Make a payment request<\/a> with a <code>PaymentTransaction<\/code> object that includes:<\/p>\n<ul>\n<li><code>TransactionConditions.AllowedPaymentBrand<\/code>: <span translate=\"no\"><strong>paypal_pos<\/strong><\/span> for a PayPal QR code, or <span translate=\"no\"><strong>venmo_pos<\/strong><\/span> for a Venmo QR code.<\/li>\n<\/ul>\n<p>The example below shows how to initiate a <strong>EUR&nbsp;10.99 PayPal<\/strong> payment from your POS app.<\/p>\n<pre><code class=\"language-json\">{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Service\",\n         \"MessageCategory\":\"Payment\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"0918171608\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-324688179\"\n      },\n      \"PaymentRequest\":{\n         \"SaleData\":{\n            \"SaleTransactionID\":{\n               \"TransactionID\":\"8954\",\n               \"TimeStamp\":\"2019-09-18T15:16:08+00:00\"\n            },\n         },\n         \"PaymentTransaction\":{\n            \"AmountsReq\":{\n               \"Currency\":\"EUR\",\n               \"RequestedAmount\":10.99\n            },\n            \"TransactionConditions\":{\n               \"AllowedPaymentBrand\":[\n                  \"paypal_pos\"\n               ]\n            }\n         }\n      }\n   }\n}<\/code><\/pre>\n<\/li>\n<li>\n<p>Hand the terminal to the shopper, so they can scan the QR code with their mobile phone and verify the payment.<\/p>\n<\/li>\n<li>\n<p>You receive the result of the payment, as you would receive the result of a card payment.<\/p>\n<\/li>\n<\/ol>\n<p>Refer to <a href=\"\/point-of-sale\/qr-code-wallets#initiate-from-cash-register\">Initiate from POS app<\/a> for a general description of this flow.<\/p>\n<h3>Consumer-presented<\/h3>\n<p>To initiate a PayPal or Venmo payment by scanning the QR code presented in the PayPal or Venmo wallet app on the shopper's phone:<\/p>\n<ol>\n<li>\n<p>Scan the shopper's QR code with your barcode scanner.<\/p>\n<\/li>\n<li>\n<p>Translate the QR code data into a <strong>12-digit numeric value<\/strong>, to be passed in the payment request.<\/p>\n<\/li>\n<li>\n<p><a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment#make-a-payment\">Make a payment request<\/a> with a <code>PaymentRequest<\/code> object that contains:<\/p>\n<ul>\n<li><code>PaymentData.PaymentInstrumentData.PaymentInstrumentType<\/code>: <span translate=\"no\"><strong>StoredValue<\/strong><\/span><\/li>\n<li>\n<p><code>PaymentData.PaymentInstrumentData.StoredValueAccountID<\/code>: the details of the barcode or QR code:<\/p>\n<ul>\n<li><code>StoredValueAccountType<\/code>: <span translate=\"no\"><strong>Other<\/strong><\/span><\/li>\n<li><code>EntryMode<\/code>: <span translate=\"no\"><strong>Scanned<\/strong><\/span><\/li>\n<li><code>IdentificationType<\/code>: <span translate=\"no\"><strong>BarCode<\/strong><\/span><\/li>\n<li><code>StoredValueID<\/code>: a numeric value representing the shopper's QR code.<\/li>\n<\/ul>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<p>The example below shows how to initiate a payment of <strong>10.99 euros<\/strong>, using a QR code with the numeric value <strong>593190468703<\/strong>.<\/p>\n<pre><code class=\"language-json\">{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Service\",\n         \"MessageCategory\":\"Payment\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"0918171609\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-324688179\"\n      },\n      \"PaymentRequest\":{\n         \"SaleData\":{\n            \"SaleTransactionID\":{\n               \"TransactionID\":\"19630\",\n               \"TimeStamp\":\"2019-09-18T15:26:39+00:00\"\n            },\n         },\n         \"PaymentData\":{\n            \"PaymentInstrumentData\":{\n               \"PaymentInstrumentType\":\"StoredValue\",\n               \"StoredValueAccountID\":{\n                  \"StoredValueAccountType\":\"Other\",\n                  \"EntryMode\":[\n                     \"Scanned\"\n                  ],\n                  \"IdentificationType\":\"BarCode\",\n                  \"StoredValueID\":\"593190468703\"\n               }\n            }\n         },\n         \"PaymentTransaction\":{\n            \"AmountsReq\":{\n               \"Currency\":\"EUR\",\n               \"RequestedAmount\":10.99\n            }\n         }\n      }\n   }\n}<\/code><\/pre>\n<\/li>\n<li>\n<p>You receive the result of the payment, as you would receive the result of a card payment.<\/p>\n<\/li>\n<\/ol>\n<p>Refer to <a href=\"\/point-of-sale\/qr-code-wallets#initiate-from-barcode-scanner\">Initiate from barcode scanner<\/a> for a general description of this flow.<\/p>\n<h2>Refunds<\/h2>\n<p>QR code wallets only support <a href=\"\/point-of-sale\/basic-tapi-integration\/refund-payment\/referenced\">referenced refunds<\/a>, so you'll have to make a <code>ReversalRequest<\/code> to refund a QR code wallet payment. Both full and partial referenced refunds are allowed.<\/p>\n<h2 id=\"testing-paypal\">Testing PayPal\/Venmo<\/h2>\n<p>To try out PayPal or Venmo payments, you can use the Adyen simulator as described in <a href=\"\/point-of-sale\/testing-pos-payments#testing-qr-code-wallets\">Testing QR code wallets<\/a>.<\/p>\n<p>But you can also use a test app and a sandbox environment provided by PayPal. The test app is an iOS app for both PayPal and Venmo. An Android test app will be available soon.<\/p>\n<p>To use the PayPal test app:<\/p>\n<ol>\n<li>\n<p><a href=\"#onboarding-paypal\">Onboard with PayPal<\/a>.<\/p>\n<\/li>\n<li>\n<p>Contact us, and provide us with:<\/p>\n<ul>\n<li>The email address where you want to receive emails from PayPal and us about the test app.<\/li>\n<li>\n<p>Your company logo in PNG format with a resolution of 150 ppi. PayPal will include that in the app.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Download the test app using the link you will receive in an email from PayPal.<\/p>\n<\/li>\n<li>\n<p>Log in to the test app using the credentials from your PayPal developer account.<\/p>\n<\/li>\n<li>\n<p>Make test payments using your personal sandbox account.<\/p>\n<\/li>\n<li>\n<p>Check the result in your personal and business sandbox accounts.<\/p>\n<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/qr-code-wallets\"\n                        target=\"_self\"\n                        >\n                    Make a QR code wallet payment\n                <\/a><\/li><li><a href=\"\/point-of-sale\/testing-pos-payments#testing-qr-code-wallets\"\n                        target=\"_self\"\n                        >\n                    Testing QR code wallets\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods\/qr-code-wallets\/paypal-pos","articleFields":{"description":"Learn how to accept in-person PayPal or Venmo QR code payments.","robots":"noindex,nofollow","feedback_component":true,"type":"page","_expandable":{"operations":""}},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods\/qr-code-wallets\/paypal-pos","title":"PayPal and Venmo","content":"PayPal or Venmo point-of-sale payments work in the same way as other QR code wallet payments at the point of sale. However, a special onboarding flow applies, and you can test your integration using a test app provided by PayPal.\nOnboard with PayPal\/Venmo\nTo enable point-of-sale PayPal or Venmo transactions through Adyen, you need to have PayPal sandbox and business accounts exclusively for Adyen point of sale. We then need to configure settings for you, both on your PayPal accounts and on the Adyen side.\n\nYou cannot use a PayPal account that you may already have for online payments or for an integration with another payment services provider.\n\n\n\nCreate a PayPal developer account, if you do not have one already.\n\n\nGo to https:\/\/developer.paypal.com and select Log in to Dashboard &gt; Sign up.\n\n\n\n\n\nCreate PayPal sandbox user accounts exclusively for Adyen point of sale. You need these accounts for testing.\n\nGo to https:\/\/developer.paypal.com and log in with your developer account.\n\nCreate a Business and a Personal sandbox account.\n\n\n\n\n\nCreate a PayPal business account for Adyen point of sale. You need this account for making live payments.\n\n\nGo to https:\/\/www.paypal.com\/us\/business and select Sign up.\n\n\n\n\n\nAsk your Adyen account manager to set up your accounts for PayPal and\/or Venmo.\nYou will receive a link to a location where you can confirm you give us permission to configure your PayPal account. We can then add the stores under your Adyen merchant account to your PayPal account.\n\n\nImplement a payment flow\nFor PayPal and Venmo we support all QR code payment flows:\n\nMerchant-presented from terminal: you launch the QR code from the terminal.\nMerchant-presented from POS app: you launch the QR code through your payment request.\nConsumer-presented: you scan the QR code that the shopper launched on their phone.\n\nMerchant-presented from terminal\nTo launch a PayPal or Venmo QR code from the terminal:\n\nInitiate a payment.\nOn the terminal, select Wallets and then either PayPal or Venmo.\nHand the terminal to the shopper, so they can scan the QR code with their mobile phone and verify the payment.\nYou receive the result of the payment, as you would receive the result of a card payment.\n\nRefer to Initiate from terminal for a general description of this flow.\nMerchant-presented from POS app\nTo launch a PayPal or Venmo QR code directly instead of by manually selecting options on the terminal:\n\n\nMake a payment request with a PaymentTransaction object that includes:\n\nTransactionConditions.AllowedPaymentBrand: paypal_pos for a PayPal QR code, or venmo_pos for a Venmo QR code.\n\nThe example below shows how to initiate a EUR&nbsp;10.99 PayPal payment from your POS app.\n{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Service\",\n         \"MessageCategory\":\"Payment\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"0918171608\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-324688179\"\n      },\n      \"PaymentRequest\":{\n         \"SaleData\":{\n            \"SaleTransactionID\":{\n               \"TransactionID\":\"8954\",\n               \"TimeStamp\":\"2019-09-18T15:16:08+00:00\"\n            },\n         },\n         \"PaymentTransaction\":{\n            \"AmountsReq\":{\n               \"Currency\":\"EUR\",\n               \"RequestedAmount\":10.99\n            },\n            \"TransactionConditions\":{\n               \"AllowedPaymentBrand\":[\n                  \"paypal_pos\"\n               ]\n            }\n         }\n      }\n   }\n}\n\n\nHand the terminal to the shopper, so they can scan the QR code with their mobile phone and verify the payment.\n\n\nYou receive the result of the payment, as you would receive the result of a card payment.\n\n\nRefer to Initiate from POS app for a general description of this flow.\nConsumer-presented\nTo initiate a PayPal or Venmo payment by scanning the QR code presented in the PayPal or Venmo wallet app on the shopper's phone:\n\n\nScan the shopper's QR code with your barcode scanner.\n\n\nTranslate the QR code data into a 12-digit numeric value, to be passed in the payment request.\n\n\nMake a payment request with a PaymentRequest object that contains:\n\nPaymentData.PaymentInstrumentData.PaymentInstrumentType: StoredValue\n\nPaymentData.PaymentInstrumentData.StoredValueAccountID: the details of the barcode or QR code:\n\nStoredValueAccountType: Other\nEntryMode: Scanned\nIdentificationType: BarCode\nStoredValueID: a numeric value representing the shopper's QR code.\n\n\n\n\nThe example below shows how to initiate a payment of 10.99 euros, using a QR code with the numeric value 593190468703.\n{\n   \"SaleToPOIRequest\":{\n      \"MessageHeader\":{\n         \"ProtocolVersion\":\"3.0\",\n         \"MessageClass\":\"Service\",\n         \"MessageCategory\":\"Payment\",\n         \"MessageType\":\"Request\",\n         \"ServiceID\":\"0918171609\",\n         \"SaleID\":\"POSSystemID12345\",\n         \"POIID\":\"V400m-324688179\"\n      },\n      \"PaymentRequest\":{\n         \"SaleData\":{\n            \"SaleTransactionID\":{\n               \"TransactionID\":\"19630\",\n               \"TimeStamp\":\"2019-09-18T15:26:39+00:00\"\n            },\n         },\n         \"PaymentData\":{\n            \"PaymentInstrumentData\":{\n               \"PaymentInstrumentType\":\"StoredValue\",\n               \"StoredValueAccountID\":{\n                  \"StoredValueAccountType\":\"Other\",\n                  \"EntryMode\":[\n                     \"Scanned\"\n                  ],\n                  \"IdentificationType\":\"BarCode\",\n                  \"StoredValueID\":\"593190468703\"\n               }\n            }\n         },\n         \"PaymentTransaction\":{\n            \"AmountsReq\":{\n               \"Currency\":\"EUR\",\n               \"RequestedAmount\":10.99\n            }\n         }\n      }\n   }\n}\n\n\nYou receive the result of the payment, as you would receive the result of a card payment.\n\n\nRefer to Initiate from barcode scanner for a general description of this flow.\nRefunds\nQR code wallets only support referenced refunds, so you'll have to make a ReversalRequest to refund a QR code wallet payment. Both full and partial referenced refunds are allowed.\nTesting PayPal\/Venmo\nTo try out PayPal or Venmo payments, you can use the Adyen simulator as described in Testing QR code wallets.\nBut you can also use a test app and a sandbox environment provided by PayPal. The test app is an iOS app for both PayPal and Venmo. An Android test app will be available soon.\nTo use the PayPal test app:\n\n\nOnboard with PayPal.\n\n\nContact us, and provide us with:\n\nThe email address where you want to receive emails from PayPal and us about the test app.\n\nYour company logo in PNG format with a resolution of 150 ppi. PayPal will include that in the app.\n\n\n\n\n\nDownload the test app using the link you will receive in an email from PayPal.\n\n\nLog in to the test app using the credentials from your PayPal developer account.\n\n\nMake test payments using your personal sandbox account.\n\n\nCheck the result in your personal and business sandbox accounts.\n\n\nSee also\n\n\n                    Make a QR code wallet payment\n                \n                    Testing QR code wallets\n                \n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Alternative payment methods","lvl3":"QR code wallet payments","lvl4":"PayPal and Venmo"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods","lvl3":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods\/qr-code-wallets","lvl4":"\/point-of-sale\/alternative-payment-methods\/qr-code-wallets\/paypal-pos"},"levels":5,"category":"In-person payments","category_color":"green","tags":["PayPal","Venmo"]}}