{"title":"Set up PayPal for your marketplace","category":"default","creationDate":1776961628,"content":"<p>PayPal is a supported payment method for marketplaces, but note that certain <a href=\"#requirements-and-limitations\">requirements and limitations<\/a> apply. To enable your marketplace users to accept online PayPal payments, you need to:<\/p>\n<ol>\n<li>\n<p><a href=\"#dev-sandbox-accounts\">Create PayPal developer and sandbox accounts<\/a>.<\/p>\n<\/li>\n<li>\n<p><a href=\"#marketplace-account\">Get a PayPal marketplace account<\/a> and give Adyen access to that account.<\/p>\n<div class=\"notices green\">\n<p>Adyen will add and configure PayPal as a payment method in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<\/div>\n<\/li>\n<li>\n<p><a href=\"#integrate-paypal\">Integrate PayPal<\/a> in your online payments flow.<\/p>\n<\/li>\n<li>\n<p>When you <a href=\"#test-and-go-live\">go live<\/a>, create a live PayPal business account and a live PayPal marketplace account.<\/p>\n<\/li>\n<\/ol>\n<h2>Requirements<\/h2>\n<p>To support PayPal payments:<\/p>\n<ul>\n<li>You must have a marketplace setup in your Adyen for Platforms integration.<br \/>\nPayPal is not supported in a <a href=\"\/pt\/classic-platforms\">classic platforms integration<\/a>.<\/li>\n<\/ul>\n<p>The supported currencies for PayPal payments are:<\/p>\n<ul>\n<li>EUR<\/li>\n<li>GBP<\/li>\n<li>USD<\/li>\n<\/ul>\n<h2 id=\"dev-sandbox-accounts\">Step 1: Create developer and sandbox accounts<\/h2>\n<p>To test your integration, you need to create a PayPal developer account and PayPal personal and business sandbox accounts.<\/p>\n<div class=\"notices yellow\">\n<p>To be able to see your test payments later, it is important that you create your <a href=\"https:\/\/developer.paypal.com\/api\/rest\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">sandbox accounts<\/a> under your PayPal <a href=\"https:\/\/developer.paypal.com\/api\/rest\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">developer account<\/a>.<\/p>\n<\/div>\n<ol>\n<li>\n<p><a href=\"https:\/\/developer.paypal.com\/api\/rest\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Create a PayPal developer account<\/a>, if you do not already have one.<br \/>\nThis account gives access to the developer dashboard where you can create and manage business and personal sandbox accounts.<\/p>\n<\/li>\n<li>\n<p>Under your developer account, <a href=\"https:\/\/developer.paypal.com\/tools\/sandbox\/accounts\/#create-a-business-sandbox-account\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">create a PayPal <span translate=\"no\"><strong>business<\/strong><\/span> sandbox account<\/a>.<br \/>\nThis account, ending in <span translate=\"no\"><strong>@business.example.com<\/strong><\/span> for example, lets you simulate the merchant's role when testing payments.<\/p>\n<\/li>\n<li>\n<p>Under your developer account, <a href=\"https:\/\/developer.paypal.com\/tools\/sandbox\/accounts\/#link-createapersonalsandboxaccount\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">create a PayPal <span translate=\"no\"><strong>personal<\/strong><\/span> sandbox account<\/a>.<br \/>\nThis account, ending in <span translate=\"no\"><strong>@personal.example.com<\/strong><\/span> for example, lets you simulate the shopper's role when testing payments.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"marketplace-account\">Step 2: Set up a PayPal marketplace account<\/h2>\n<p>You need to create a PayPal marketplace account and give Adyen permission to access that account so that we can connect it to your Adyen integration.<\/p>\n<ol>\n<li>\n<p>Ask your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.<\/p>\n<\/li>\n<li>\n<p>When you have your PayPal marketplace account, ask your Adyen contact for a <strong>referral URL<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Using the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"integrate-paypal\">Step 3: Integrate PayPal payments<\/h2>\n<p>When your Adyen contact has informed you that we have completed configuring PayPal in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>:<\/p>\n<ol>\n<li>Ask your PayPal account manager what <a href=\"\/pt\/payment-methods\/paypal#paypal-risk-data\">PayPal risk data<\/a> you must provide.<\/li>\n<li>Build your PayPal integration including:\n<ul>\n<li><a href=\"\/pt\/marketplaces\/split-transactions\">Split payment data<\/a>.<\/li>\n<li>The <code>paypalRisk<\/code> fields that PayPal told you to include. For instructions, see the PayPal page for your integration type.<\/li>\n<\/ul><\/li>\n<\/ol>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/payment-methods\/paypal\/web-drop-in\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Drop-in<\/h6><p>Add PayPal to your existing Web Drop-in integration.<\/p><\/div><\/p><\/a><a href=\"\/payment-methods\/paypal\/web-component\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Components<\/h6><p>Add PayPal to your existing Web Components integration.<\/p><\/div><\/p><\/a><\/div>\n\n<h2 id=\"test-and-go-live\">Test and go live<\/h2>\n<h3>Test your integration<\/h3>\n<p>When you are done setting up your integration, use your <a href=\"#dev-sandbox-accounts\">PayPal sandbox accounts<\/a> to test the PayPal payment flow. Your <span translate=\"no\"><strong>business<\/strong><\/span> sandbox account lets you simulate your role as a merchant when testing payments. With your <span translate=\"no\"><strong>personal<\/strong><\/span> sandbox account you can simulate the role of a shopper.<\/p>\n<p>For more information, see the <a href=\"https:\/\/developer.paypal.com\/api\/rest\/sandbox\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">PayPal sandbox testing guide<\/a>.<\/p>\n<p>You can check the status of a PayPal test payment in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>\u00a0&gt;\u00a0<strong>Transactions<\/strong>\u00a0&gt;\u00a0<strong>Payments<\/strong>.<\/p>\n<h3>Before you go live<\/h3>\n<p>For live operations, you need to set up a live PayPal business account and a live PayPal marketplace account.<\/p>\n<ol>\n<li>\n<p>Create a live PayPal business account:<\/p>\n<ol>\n<li>\n<p>Go to the <a href=\"https:\/\/www.paypal.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">PayPal website<\/a>, select <span translate=\"no\"><strong>Sign Up<\/strong><\/span>, and follow the instructions.<\/p>\n<div class=\"notices yellow\">\n<p>Do not use a personal email address for your live PayPal business account. We strongly recommend that you use a generic company email address. This is to prevent having to configure a new account for your business in the future, should the personal email address no longer be in use for any reason. The email address for your live PayPal business account will also be shown on the payment receipt the shopper receives from PayPal.<\/p>\n<\/div>\n<\/li>\n<li>\n<p><a href=\"https:\/\/www.paypal.com\/c2\/webapps\/mpp\/how-to-guides\/activate-your-business-account?locale.x=en_C2\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Activate<\/a> your business account.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>Create a live PayPal marketplace account:<\/p>\n<ol>\n<li>Ask your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.<\/li>\n<li>When you have your PayPal marketplace account, ask your Adyen contact for a <strong>referral URL<\/strong>.<\/li>\n<li>Using the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.<\/li>\n<\/ol>\n<div class=\"notices green\">\n<p>Adyen will add and configure PayPal as a payment method in your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a>.<\/p>\n<\/div>\n<\/li>\n<\/ol>\n<h2>Chargebacks<\/h2>\n<p>When a shopper (a buyer on your marketplace) doesn't agree with a PayPal payment, they can raise a dispute either:<\/p>\n<ul>\n<li>Through their bank or card issuer.<\/li>\n<li>Directly with the seller on your marketplace or in the PayPal Resolution Center.<\/li>\n<\/ul>\n<p>When PayPal informs Adyen that a payment is disputed, we do not know to which seller on your marketplace this payment belongs. All we can do is inform you of the dispute, and let you review and defend the dispute on behalf of your seller. You can do this using the Adyen <a href=\"\/pt\/risk-management\/disputes-api\">Disputes API<\/a> or your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<p>As a marketplace, you have to implement your own business logic to manage disputes on behalf of your sellers.<\/p>\n<p>You have a limited number of days to respond to a dispute before it is lost in the shopper's favor. You can see the number of days remaining on the dispute details page.  For details, see <a href=\"\/pt\/risk-management\/chargeback-guidelines\/paypal-chargebacks\">PayPal chargebacks<\/a>.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/paypal\/setup-paypal-marketplaces","articleFields":{"description":"Create a PayPal environment and add PayPal to your marketplace.","type":"page","parameters":{"payment_method":"PayPal"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/paypal\/setup-paypal-marketplaces","title":"Set up PayPal for your marketplace","content":"PayPal is a supported payment method for marketplaces, but note that certain requirements and limitations apply. To enable your marketplace users to accept online PayPal payments, you need to:\n\n\nCreate PayPal developer and sandbox accounts.\n\n\nGet a PayPal marketplace account and give Adyen access to that account.\n\nAdyen will add and configure PayPal as a payment method in your Customer Area.\n\n\n\nIntegrate PayPal in your online payments flow.\n\n\nWhen you go live, create a live PayPal business account and a live PayPal marketplace account.\n\n\nRequirements\nTo support PayPal payments:\n\nYou must have a marketplace setup in your Adyen for Platforms integration.\nPayPal is not supported in a classic platforms integration.\n\nThe supported currencies for PayPal payments are:\n\nEUR\nGBP\nUSD\n\nStep 1: Create developer and sandbox accounts\nTo test your integration, you need to create a PayPal developer account and PayPal personal and business sandbox accounts.\n\nTo be able to see your test payments later, it is important that you create your sandbox accounts under your PayPal developer account.\n\n\n\nCreate a PayPal developer account, if you do not already have one.\nThis account gives access to the developer dashboard where you can create and manage business and personal sandbox accounts.\n\n\nUnder your developer account, create a PayPal business sandbox account.\nThis account, ending in @business.example.com for example, lets you simulate the merchant's role when testing payments.\n\n\nUnder your developer account, create a PayPal personal sandbox account.\nThis account, ending in @personal.example.com for example, lets you simulate the shopper's role when testing payments.\n\n\nStep 2: Set up a PayPal marketplace account\nYou need to create a PayPal marketplace account and give Adyen permission to access that account so that we can connect it to your Adyen integration.\n\n\nAsk your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.\n\n\nWhen you have your PayPal marketplace account, ask your Adyen contact for a referral URL.\n\n\nUsing the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.\n\n\nStep 3: Integrate PayPal payments\nWhen your Adyen contact has informed you that we have completed configuring PayPal in your Customer Area:\n\nAsk your PayPal account manager what PayPal risk data you must provide.\nBuild your PayPal integration including:\n\nSplit payment data.\nThe paypalRisk fields that PayPal told you to include. For instructions, see the PayPal page for your integration type.\n\n\n\nDrop-inAdd PayPal to your existing Web Drop-in integration.ComponentsAdd PayPal to your existing Web Components integration.\n\nTest and go live\nTest your integration\nWhen you are done setting up your integration, use your PayPal sandbox accounts to test the PayPal payment flow. Your business sandbox account lets you simulate your role as a merchant when testing payments. With your personal sandbox account you can simulate the role of a shopper.\nFor more information, see the PayPal sandbox testing guide.\nYou can check the status of a PayPal test payment in your Customer Area\u00a0&gt;\u00a0Transactions\u00a0&gt;\u00a0Payments.\nBefore you go live\nFor live operations, you need to set up a live PayPal business account and a live PayPal marketplace account.\n\n\nCreate a live PayPal business account:\n\n\nGo to the PayPal website, select Sign Up, and follow the instructions.\n\nDo not use a personal email address for your live PayPal business account. We strongly recommend that you use a generic company email address. This is to prevent having to configure a new account for your business in the future, should the personal email address no longer be in use for any reason. The email address for your live PayPal business account will also be shown on the payment receipt the shopper receives from PayPal.\n\n\n\nActivate your business account.\n\n\n\n\nCreate a live PayPal marketplace account:\n\nAsk your Adyen contact to ensure PayPal sends you the details of your PayPal marketplace account.\nWhen you have your PayPal marketplace account, ask your Adyen contact for a referral URL.\nUsing the referral URL, log in to your PayPal marketplace account and confirm you give Adyen permission to access this account.\n\n\nAdyen will add and configure PayPal as a payment method in your live Customer Area.\n\n\n\nChargebacks\nWhen a shopper (a buyer on your marketplace) doesn't agree with a PayPal payment, they can raise a dispute either:\n\nThrough their bank or card issuer.\nDirectly with the seller on your marketplace or in the PayPal Resolution Center.\n\nWhen PayPal informs Adyen that a payment is disputed, we do not know to which seller on your marketplace this payment belongs. All we can do is inform you of the dispute, and let you review and defend the dispute on behalf of your seller. You can do this using the Adyen Disputes API or your Customer Area.\nAs a marketplace, you have to implement your own business logic to manage disputes on behalf of your sellers.\nYou have a limited number of days to respond to a dispute before it is lost in the shopper's favor. You can see the number of days remaining on the dispute details page.  For details, see PayPal chargebacks.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"PayPal","lvl3":"Set up PayPal for your marketplace"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/paypal","lvl3":"\/pt\/payment-methods\/paypal\/setup-paypal-marketplaces"},"levels":4,"category":"Payment method","category_color":"green","tags":["PayPal","marketplace"]}}