{"title":"Create and manage donation campaigns","category":"default","creationDate":1783952580,"content":"

With Adyen Giving, your users can give shoppers the option to donate to a nonprofit organization when shoppers make a purchase, either online or at the point of sale. To enable this, you set up donation campaigns for account holders<\/a>, or you build your own UI to let your users self-serve their donation campaigns.<\/p>\n

This page describes how to set up and manage donation campaigns. A campaign can be for online payments, for in-person payments, or for both online and in-person payments. To learn how to handle payments with donations after a donation campaign is set up and has started, refer to Online donations<\/a> or In-person donations<\/a>.<\/p>\n

Requirements<\/h2>\n

Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n\n\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nAdyen for Platforms with a platform model, with an API only<\/a> online payments integration using Checkout API v67 or later, and\/or a Terminal API integration with payment terminals or a Standalone solution. The terminals must use terminal software version 1.109 or later. Some terminals or features require software version 1.110 or later.<\/td>\n<\/tr>\n
API credentials<\/a><\/strong><\/td>\nTo create and manage donation campaigns using API requests, your API credential must have the following role:
  • Management API - Campaign Management read and write<\/strong><\/li><\/ul><\/td>\n<\/tr>\n
Customer Area roles<\/a><\/strong><\/td>\nTo create and manage donation campaigns using the Customer Area, you must have the following roles:
  • Donation campaigns viewer<\/strong>: to view donation campaigns and access campaign insights.<\/li>
  • Donation campaigns manager<\/strong>: to create, start, edit, and end donation campaigns and access campaign insights.<\/li><\/ul><\/td>\n<\/tr>\n
Limitations<\/strong><\/td>\nNote the following limitations:
Setup steps<\/strong><\/td>\nBefore you begin, make sure that the nonprofit you choose has been onboarded to Adyen. You can also pick one of our pre-approved nonprofits<\/a> that have already been onboarded.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Donation options<\/h2>\n

With our Giving integration, you have the flexibility to choose a combination of interaction flow and donation type.<\/p>\n

However, there are limitations to the supported choices, depending on region and currency<\/a> and payment method<\/a>. With in-person payments, there are also limitations with regard to terminal model<\/a>.<\/p>\n

Interaction flow<\/h3>\n\n
\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n<\/li>\n<\/ul>\n

Donation type<\/h3>\n\n
\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Set up a donation campaign for account holders<\/h2>\n

To create a donation campaign, you can use your Customer Area or make API calls. Select the tab for the method you want to use.<\/p>\n\n

\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Manage donation campaigns<\/h2>\n

To manage the life cycle of account holder donation campaigns, you can use your Customer Area or make API calls. Select the tab for the method you want to use.<\/p>\n\n

\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Next steps<\/h2>\n
\n
Implement online donations<\/div>

Integrate Adyen Giving to let shoppers donate during online payments.<\/p><\/p><\/a>

Implement in-person donations<\/div>

Integrate Adyen Giving to let shoppers donate at the point of sale.<\/p><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/platforms\/donations\/create-manage-campaigns","articleFields":{"description":"Set up donation campaigns and manage the campaign life cycle in the Customer Area or using API calls.","feedback_component":true,"parameters":{"payment_method":"Giving","model":"platform"},"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/platforms\/donations\/create-manage-campaigns","title":"Create and manage donation campaigns","content":"With Adyen Giving, your users can give shoppers the option to donate to a nonprofit organization when shoppers make a purchase, either online or at the point of sale. To enable this, you set up donation campaigns for account holders, or you build your own UI to let your users self-serve their donation campaigns.\nThis page describes how to set up and manage donation campaigns. A campaign can be for online payments, for in-person payments, or for both online and in-person payments. To learn how to handle payments with donations after a donation campaign is set up and has started, refer to Online donations or In-person donations.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nAdyen for Platforms with a platform model, with an API only online payments integration using Checkout API v67 or later, and\/or a Terminal API integration with payment terminals or a Standalone solution. The terminals must use terminal software version 1.109 or later. Some terminals or features require software version 1.110 or later.\n\n\nAPI credentials\nTo create and manage donation campaigns using API requests, your API credential must have the following role: Management API - Campaign Management read and write\n\n\nCustomer Area roles\nTo create and manage donation campaigns using the Customer Area, you must have the following roles: Donation campaigns viewer: to view donation campaigns and access campaign insights. Donation campaigns manager: to create, start, edit, and end donation campaigns and access campaign insights.\n\n\nLimitations\nNote the following limitations: The maximum number of account holders that you can assign to a donation campaign is 400. A store can only be part of one active campaign at the same time. Make sure that you are using supported payment methods and supported regions and currencies.\n\n\nSetup steps\nBefore you begin, make sure that the nonprofit you choose has been onboarded to Adyen. You can also pick one of our pre-approved nonprofits that have already been onboarded.\n\n\n\nDonation options\nWith our Giving integration, you have the flexibility to choose a combination of interaction flow and donation type.\nHowever, there are limitations to the supported choices, depending on region and currency and payment method. With in-person payments, there are also limitations with regard to terminal model.\nInteraction flow\n\n\n \n \n \n \n\n\n\nDonation type\n\n\n \n \n \n \n\n\nSet up a donation campaign for account holders\nTo create a donation campaign, you can use your Customer Area or make API calls. Select the tab for the method you want to use.\n\n\n \n \n \n \n\n\nManage donation campaigns\nTo manage the life cycle of account holder donation campaigns, you can use your Customer Area or make API calls. Select the tab for the method you want to use.\n\n\n \n \n \n \n\n\nNext steps\n\nImplement online donationsIntegrate Adyen Giving to let shoppers donate during online payments.Implement in-person donationsIntegrate Adyen Giving to let shoppers donate at the point of sale.\n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Adyen Giving donation campaigns","lvl3":"Create and manage donation campaigns"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/platforms","lvl2":"https:\/\/docs.adyen.com\/platforms\/donations","lvl3":"\/platforms\/donations\/create-manage-campaigns"},"levels":4,"category":"Platforms","category_color":"green","tags":["Create","manage","donation","campaigns"]}}