{"title":"Online donations using Adyen Giving","category":"default","creationDate":1779796135,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Read more<\/h5><div class=\"additional-info-block__body\"><p><img style=\"width: 28px;\" alt=\"Giving logo\" src=\"\/user\/pages\/docs\/05.platforms\/27.online-payments\/06.donations-online\/giving.svg?decoding=auto&amp;fetchpriority=auto\" \/>&nbsp;Learn about Adyen Giving <a href=\"\/platforms\/in-person-payments\/donations-in-person\">on your payment terminals<\/a>.<\/p><\/div><\/div>\n\n<p>With Adyen Giving, your users can give shoppers the option to donate to a nonprofit organization when shoppers make an online purchase. To enable this, you set up donation campaigns for <a href=\"\/platforms\/account-structure-resources#balance-platform-resources\" target=\"_blank\">account holder resources<\/a>.<\/p>\n<p>When a campaign has been started and a shopper chooses to donate, the donation is processed as a separate transaction. Adyen covers all fees and the donation amount is transferred to the nonprofit in full. This means you can split amounts and fees on the original transaction, but not on the donation transaction.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">Adyen for Platforms with a platform model, with an <a href=\"\/online-payments\/donations\/api-only\">API only<\/a> online payments integration using Checkout API v67 or later.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/account\/user-roles\">Customer Area roles<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have the following roles: <ul><li markdown=\"1\"><strong>Donation campaigns viewer<\/strong>: to view donation campaigns and access campaign insights.<\/li> <li markdown=\"1\"><strong>Donation campaigns manager<\/strong>: to create, start, edit, and end donation campaigns and access campaign insights.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/development-resources\/webhooks\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Subscribe to the <strong><a href=\"\/development-resources\/webhooks\/webhook-types#other-webhooks\">Adyen Giving merchant webhook<\/a><\/strong>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Note the following limitations: <ul><li markdown=\"1\">The maximum number of account holders that you can assign to a donation campaign is 400.<\/li> <li markdown=\"1\">A store can only be part of one active campaign at the same time.<\/li> <li markdown=\"1\">Make sure that you are using <a href=\"\/platforms\/donations#supported-payment-methods\">supported payment methods<\/a> and <a href=\"\/platforms\/donations#supported-currencies\">supported regions and currencies<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Before you begin, make sure that the nonprofit you choose has been onboarded to Adyen, or pick one of our <a href=\"https:\/\/www.adyen.com\/giving\/nonprofit\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">pre-approved nonprofits<\/a> that have already been onboarded.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>How it works<\/h2>\n<p>To enable your users to accept donations at checkout:<\/p>\n<ol>\n<li>\n<p><a href=\"\/platforms\/donations#nonprofit-organizations\" target=\"_blank\">Choose a nonprofit<\/a>.<\/p>\n<\/li>\n<li>\n<p><a href=\"#set-up-a-donation-campaign\">Set up an account holder donation campaign<\/a> in your Customer Area, under <strong>Giving<\/strong> &gt; <strong>Campaigns<\/strong>.<br \/>\nYou need to select:<\/p>\n<ul>\n<li>The account holders that you want to make the campaign available to.<\/li>\n<li>The nonprofit.<\/li>\n<li>\n<p>The stores and <a href=\"#donation-settings\">donation settings<\/a>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Make sure that your integration can show the active campaign in your checkout, and make a request for the amount that the shopper wants to donate. See <a href=\"#online-payments-flow\">Online payments flow<\/a>.<\/p>\n<\/li>\n<li>\n<p>Make sure you have a way to <a href=\"\/online-payments\/donations\/terms-and-conditions\" target=\"_blank\">show the nonprofit's terms and conditions<\/a>.<\/p>\n<\/li>\n<li>\n<p>To inform shoppers about their donation, make sure that you can process <a href=\"#giving-webhook\">Giving webhook messages<\/a>.<\/p>\n<\/li>\n<li>\n<p>Start the campaign from the <strong>Campaigns<\/strong> overview in your Customer Area.<\/p>\n<\/li>\n<\/ol>\n<h2>Donation settings<\/h2>\n<p>With our Giving integration, you have the flexibility to choose a combination of donation type and donation moment.<\/p>\n<p>However, there are limitations to the supported choices, depending on <a href=\"\/platforms\/donations#supported-currencies\">region and currency<\/a> and <a href=\"\/platforms\/donations#supported-payment-methods\">payment method<\/a>.<\/p>\n<h3 id=\"donation-type\">Donation type<\/h3>\n<p>In your <a href=\"#set-up-a-donation-campaign\">donation campaign<\/a> you can configure the following donation types:<\/p>\n<ul>\n<li><strong>Fixed amounts<\/strong>: up to three fixed amounts to present to shoppers when they make a payment. Your checkout should provide a selection mechanism, such as donation buttons for these amounts.<\/li>\n<li><strong>Round up<\/strong>: allow shoppers to donate by rounding up the transaction amount of their purchase. Your checkout should show a round-up checkbox. We recommend rounding up to the nearest whole amount.<\/li>\n<\/ul>\n<h3 id=\"donation-moment\">Donation moment<\/h3>\n<p>Your integration can present the option to donate at different moments in your checkout flow:<\/p>\n<ul>\n<li><strong>Pre-checkout<\/strong>: the shopper can review the total transaction amount that includes the donation before completing their payment.<\/li>\n<li><strong>Post-checkout<\/strong>: the shopper can contribute to your donation campaign after completing their payment. This gives you flexibility to align Giving with your existing checkout process.<\/li>\n<\/ul>\n<h2 id=\"set-up-a-donation-campaign\">Set up a donation campaign for account holders<\/h2>\n<p>The Campaigns user interface in the Customer Area guides you through setting up a donation campaign, and shows example screens. The main steps to create an Adyen Giving donation campaign for your account holders are as follows:<\/p>\n<ol>\n<li>\n<p>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, go to <strong>Giving<\/strong> &gt; <strong>Campaigns<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Create new campaign<\/strong> &gt; <strong>For account holders<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Add the account holders to the campaign, one by one or as a group:<\/p>\n<ul>\n<li>One by one: select <strong>Search accounts<\/strong>, select your balance platform, and search by account holder ID or reference, legal entity ID or name, or email address. Then select <strong>Add<\/strong> in the tile of the individual account holder.<\/li>\n<li>Group: select <strong>Submit a list of accounts<\/strong>, select your balance platform, enter a comma-separated list of account holder IDs, and select <strong>Add<\/strong>.<\/li>\n<\/ul>\n<p>The UI will inform you if an account holder has already been added or cannot be found on the selected balance platform.<\/p>\n<\/li>\n<li>\n<p>Select the campaign details:<\/p>\n<ul>\n<li>The nonprofit.<\/li>\n<li>Either a specific cause, or \"General fundraising\".<\/li>\n<li>\n<p>The sales channel: online payments (ecommerce), in-person payments (point of sale), or both.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>If you selected online payments, first select the stores that the campaign applies to.<br \/>\nThen select the donation type. When you choose fixed amounts and enter the amounts in your default currency, we automatically add equivalent amounts in other currencies if necessary for the selected stores.<\/p>\n<\/li>\n<li>\n<p>If you selected in-person payments, first select the stores that the campaign applies to.<br \/>\nThen  refer to <a href=\"\/platforms\/in-person-payments\/donations-in-person#donation-settings\">in-person donation settings<\/a>, and  select:<\/p>\n<ul>\n<li>The one-step or two-step interaction flow.<\/li>\n<li>Timeouts for the donation prompt and the payment screen.<\/li>\n<li>The text to show on the donation screen on the terminal: the name of the nonprofit or the cause you selected.<\/li>\n<li>\n<p>The donation type. When you choose fixed amounts and enter the amounts in your default currency, we automatically add equivalent amounts in other currencies if necessary for the selected stores.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Review the summary. When everything is correct, select <strong>Create campaign<\/strong>.<\/p>\n<\/li>\n<\/ol>\n<p>The campaign is now set up, but not active yet.<\/p>\n<p>When you are ready to activate the campaign:<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, go to <strong>Giving<\/strong> &gt; <strong>Campaigns<\/strong>.<\/li>\n<li>Find the tile for the campaign, and select <strong>Start<\/strong>.<\/li>\n<\/ol>\n<h2>Online payments flow<\/h2>\n<p>The donation flow depends on the <a href=\"\/online-payments\/donations#donation-moment\">donation moment<\/a>:<\/p>\n\n<div id=\"tab91zRP\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Pre-checkout donations&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When your shopper goes to the checkout page and proceeds to pay with a &lt;a href=\\&quot;\\\/online-payments\\\/donations#supported-payment-methods\\&quot;&gt;payment method that supports donations&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From your server, make a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; request to &lt;a href=\\&quot;#get-details-of-donation-campaigns\\&quot;&gt;get the details of your active donation campaigns&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Depending on the  &lt;a href=\\&quot;#donation-type\\&quot;&gt;donation type&lt;\\\/a&gt;  of the campaign, &lt;a href=\\&quot;#present-option-to-donate\\&quot;&gt;present the option to donate&lt;\\\/a&gt; by either:\\n&lt;ul&gt;\\n&lt;li&gt;Show the shopper a donation form with fixed amounts.&lt;\\\/li&gt;\\n&lt;li&gt;Show the shopper a round-up checkbox that suggests to round up their payment amount as a donation.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;From your server, make a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt; request to make the payment for the original transaction.&lt;\\\/li&gt;\\n&lt;li&gt;After you get the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt; response, make a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donations&lt;\\\/a&gt; request to &lt;a href=\\&quot;#make-a-donation\\&quot;&gt;make a donation&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#giving-webhook\\&quot;&gt;Get the outcome&lt;\\\/a&gt; from a webhook and show it to the shopper.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The following diagram shows the donation flow for a round-up amount before the shopper pays for their original transaction:&lt;\\\/p&gt;\\n&lt;div style=\\&quot;text-align: center;\\&quot;&gt;\\n&lt;p&gt;&lt;img alt=\\&quot;Flow diagram for pre-checkout donations\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/online-payments\\\/donations\\\/online-process\\\/api-pre-flow.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;pre-how&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Post-checkout donations&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;When your shopper completes their payment with a  &lt;a href=\\&quot;\\\/platforms\\\/donations#supported-payment-methods\\&quot;&gt;payment method that supports donations&lt;\\\/a&gt; :&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;From your server, make a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; request to &lt;a href=\\&quot;#get-details-of-donation-campaigns\\&quot;&gt;get the details of your active donation campaigns&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Depending on the  &lt;a href=\\&quot;\\\/platforms\\\/online-payments\\\/donations-online#donation-type\\&quot;&gt;donation type&lt;\\\/a&gt;  of the campaign, &lt;a href=\\&quot;#present-option-to-donate\\&quot;&gt;present the option to donate&lt;\\\/a&gt; by either:\\n&lt;ul&gt;\\n&lt;li&gt;Show the shopper a donation form with fixed amounts.&lt;\\\/li&gt;\\n&lt;li&gt;Show the shopper a round-up checkbox that suggests to round up their payment amount as a donation.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;&lt;\\\/li&gt;\\n&lt;li&gt;From your server, make a  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donations&lt;\\\/a&gt; request to &lt;a href=\\&quot;#make-a-donation\\&quot;&gt;make a donation&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;a href=\\&quot;#giving-webhook\\&quot;&gt;Get the outcome&lt;\\\/a&gt; from a webhook and show it to the shopper.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;p&gt;The following diagram shows the donation flow for a fixed amount donation before the shopper pays for their original transaction.&lt;\\\/p&gt;\\n&lt;div style=\\&quot;text-align: center;\\&quot;&gt;\\n&lt;p&gt;&lt;img alt=\\&quot;Flow diagram for post-checkout donations\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/online-payments\\\/donations\\\/online-process\\\/campaign-manager-api.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:&quot;post-how&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"get-details-of-donation-campaigns\">Get details of your active donation campaigns<\/h2>\n<p>Depending on the <a href=\"#donation-moment\">donation moment<\/a> that you choose, get the details of your active donation campaigns at either moment:<\/p>\n<ul>\n<li>When a shopper proceeds to pay for their original transaction with a payment method that supports donations.<\/li>\n<li>When a shopper completes their original transaction with a payment method that supports donations, and the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> or  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/details\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/details<\/a> (for iDEAL payments) response includes the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#responses-200-donationToken\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">donationToken<\/a> field.<\/li>\n<\/ul>\n<p>When you make a request to get your active donation campaigns, the response you receive depends on your <a href=\"#donation-type\">donation type<\/a>:<\/p>\n\n<div id=\"tabBDyE5\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Fixed amount donations&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;From your server, make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; request, specifying:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;merchantAccount&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your merchant account name.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;currency&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The three-character &lt;a href=\\&quot;https:\\\/\\\/en.wikipedia.org\\\/wiki\\\/ISO_4217\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;ISO currency code&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;store&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your reference for the user&#039;s store. Use this to get the donation campaigns that are available for a specific store.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;locale&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The language in which you want to receive the donation campaign details in the response. The default is configured by the nonprofit. Set it to the shopper&#039;s language and country code, for example, &lt;code&gt;en-US&lt;\\\/code&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donationCampaigns request on a platform&#039;\\&quot; :id=\\&quot;&#039;get-donation-campaigns-platform&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/checkout-test.adyen.com\\\\\\\/v72\\\\\\\/donationCampaigns \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n   \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n   \\\\&amp;quot;locale\\\\&amp;quot;: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n   \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v41.1.1\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.checkout.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.model.RequestOptions;\\\\nimport com.adyen.service.checkout.*;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nDonationCampaignsRequest donationCampaignsRequest = new DonationCampaignsRequest()\\\\n  .merchantAccount(\\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;)\\\\n  .currency(\\\\&amp;quot;EUR\\\\&amp;quot;)\\\\n  .locale(\\\\&amp;quot;en-US\\\\&amp;quot;)\\\\n  .store(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nDonationsApi service = new DonationsApi(client);\\\\nDonationCampaignsResponse response = service.donationCampaigns(donationCampaignsRequest, new RequestOptions().idempotencyKey(\\\\&amp;quot;UUID\\\\&amp;quot;));&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\\\/\\\\\\\/ Adyen PHP API Library v29.0.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Checkout\\\\\\\\DonationCampaignsRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\Checkout\\\\\\\\DonationsApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$donationCampaignsRequest = new DonationCampaignsRequest();\\\\n$donationCampaignsRequest\\\\n  -&amp;gt;setMerchantAccount(\\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;)\\\\n  -&amp;gt;setCurrency(\\\\&amp;quot;EUR\\\\&amp;quot;)\\\\n  -&amp;gt;setLocale(\\\\&amp;quot;en-US\\\\&amp;quot;)\\\\n  -&amp;gt;setStore(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;);\\\\n\\\\n$requestOptions[&#039;idempotencyKey&#039;] = &#039;UUID&#039;;\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\n$service = new DonationsApi($client);\\\\n$response = $service-&amp;gt;donationCampaigns($donationCampaignsRequest, $requestOptions);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .NET API Library v34.0.3\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.Checkout;\\\\nusing Adyen.Service.Checkout;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nDonationCampaignsRequest donationCampaignsRequest = new DonationCampaignsRequest\\\\n{\\\\n  MerchantAccount = \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  Currency = \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  Locale = \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  Store = \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nvar service = new DonationsService(client);\\\\nvar response = service.DonationCampaigns(donationCampaignsRequest, requestOptions: new RequestOptions { IdempotencyKey = \\\\&amp;quot;UUID\\\\&amp;quot;});&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v21.2.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/checkout\\\\&amp;quot;\\\\n)\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\ndonationCampaignsRequest := checkout.DonationCampaignsRequest{\\\\n  MerchantAccount: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  Currency: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  Locale: common.PtrString(\\\\&amp;quot;en-US\\\\&amp;quot;),\\\\n  Store: common.PtrString(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nservice := client.Checkout()\\\\nreq := service.DonationsApi.DonationCampaignsInput().IdempotencyKey(\\\\&amp;quot;UUID\\\\&amp;quot;).DonationCampaignsRequest(donationCampaignsRequest)\\\\nres, httpRes, err := service.DonationsApi.DonationCampaigns(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v15.0.1\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  \\\\&amp;quot;locale\\\\&amp;quot;: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.checkout.donations_api.donation_campaigns(request=json_request, idempotency_key=\\\\&amp;quot;UUID\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v11.3.0\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :merchantAccount =&amp;gt; &#039;YOUR_MERCHANT_ACCOUNT&#039;,\\\\n  :currency =&amp;gt; &#039;EUR&#039;,\\\\n  :locale =&amp;gt; &#039;en-US&#039;,\\\\n  :store =&amp;gt; &#039;USER_STORE_REFERENCE&#039;\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.checkout.donations_api.donation_campaigns(request_body, headers: { &#039;Idempotency-Key&#039; =&amp;gt; &#039;UUID&#039; })&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v30.1.0\\\\nimport { Client, CheckoutAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst donationCampaignsRequest: Types.checkout.DonationCampaignsRequest = {\\\\n  merchantAccount: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  currency: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  locale: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  store: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst checkoutAPI = new CheckoutAPI(client);\\\\nconst response = checkoutAPI.DonationsApi.donationCampaigns(donationCampaignsRequest, { idempotencyKey: \\\\&amp;quot;UUID\\\\&amp;quot; });&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;From the response, get the details of your active donation campaign(s). You need these details &lt;a href=\\&quot;#present-option-to-donate\\&quot;&gt;to create the donation form that you show to the shopper&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;id&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique campaign ID of the donation campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;campaignName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The name of the donation campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;donation&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Specifies the details of the donation. This object has: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;fixedAmounts&lt;\\\/strong&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;currency&lt;\\\/code&gt;: The three-character &lt;a href=\\&quot;\\\/development-resources\\\/currency-codes\\\/\\&quot;&gt;ISO currency code&lt;\\\/a&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;values&lt;\\\/code&gt;: Specifies the fixed donation amounts the shopper can choose from.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;causeName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The cause of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;logoUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL for the logo of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;bannerUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL for the banner of the nonprofit or campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The name of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitDescription&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The description of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The website URL of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;termsAndConditionsUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL of the terms and conditions page of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donationCampaigns response for a fixed amount donation&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;bash\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;donationCampaigns\\\\\\&quot;: [\\\\n        {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;DONATION_CAMPAIGN_ID\\\\\\&quot;,\\\\n            \\\\\\&quot;campaignName\\\\\\&quot;: \\\\\\&quot;DONATION_CAMPAIGN_NAME\\\\\\&quot;,\\\\n            \\\\\\&quot;donation\\\\\\&quot;: {\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;fixedAmounts\\\\\\&quot;,\\\\n                \\\\\\&quot;values\\\\\\&quot;: [100, 200, 300]\\\\n            },\\\\n            \\\\\\&quot;nonprofitName\\\\\\&quot;: \\\\\\&quot;NONPROFIT_NAME\\\\\\&quot;,\\\\n            \\\\\\&quot;causeName\\\\\\&quot;: \\\\\\&quot;NONPROFIT_CAUSE\\\\\\&quot;,\\\\n            \\\\\\&quot;nonprofitDescription\\\\\\&quot;: \\\\\\&quot;NONPROFIT_DESCRIPTION.\\\\\\&quot;,\\\\n            \\\\\\&quot;nonprofitUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_WEBSITE_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;logoUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_LOGO_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;bannerUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_BANNER_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;termsAndConditionsUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_TERMS_AND_CONDITIONS_URL\\\\\\&quot;\\\\n        }\\\\n    ]\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;fixed&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;fixed&quot;},{&quot;title&quot;:&quot;Round-up donations&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;From your server, make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; request, specifying:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;merchantAccount&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your merchant account name.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;currency&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The three-character &lt;a href=\\&quot;https:\\\/\\\/en.wikipedia.org\\\/wiki\\\/ISO_4217\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;ISO currency code&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;store&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your reference for the user&#039;s store. Use this to get the donation campaigns that are available for a specific store.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;locale&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The language in which you want to receive the donation campaign details in the response. The default is configured by the nonprofit. Set it to the shopper&#039;s language and country code, for example, &lt;code&gt;en-US&lt;\\\/code&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donationCampaigns request on a platform&#039;\\&quot; :id=\\&quot;&#039;get-donation-campaigns-platform&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;curl&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/checkout-test.adyen.com\\\\\\\/v72\\\\\\\/donationCampaigns \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n   \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n   \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n   \\\\&amp;quot;locale\\\\&amp;quot;: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n   \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}&#039;&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;java&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Java&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Java API Library v41.1.1\\\\nimport com.adyen.Client;\\\\nimport com.adyen.enums.Environment;\\\\nimport com.adyen.model.checkout.*;\\\\nimport java.time.OffsetDateTime;\\\\nimport java.util.*;\\\\nimport com.adyen.model.RequestOptions;\\\\nimport com.adyen.service.checkout.*;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nClient client = new Client(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;, Environment.TEST);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nDonationCampaignsRequest donationCampaignsRequest = new DonationCampaignsRequest()\\\\n  .merchantAccount(\\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;)\\\\n  .currency(\\\\&amp;quot;EUR\\\\&amp;quot;)\\\\n  .locale(\\\\&amp;quot;en-US\\\\&amp;quot;)\\\\n  .store(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;);\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nDonationsApi service = new DonationsApi(client);\\\\nDonationCampaignsResponse response = service.donationCampaigns(donationCampaignsRequest, new RequestOptions().idempotencyKey(\\\\&amp;quot;UUID\\\\&amp;quot;));&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;php&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;PHP&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;&amp;lt;?php\\\\n\\\\\\\/\\\\\\\/ Adyen PHP API Library v29.0.0\\\\nuse Adyen\\\\\\\\Client;\\\\nuse Adyen\\\\\\\\Environment;\\\\nuse Adyen\\\\\\\\Model\\\\\\\\Checkout\\\\\\\\DonationCampaignsRequest;\\\\nuse Adyen\\\\\\\\Service\\\\\\\\Checkout\\\\\\\\DonationsApi;\\\\n\\\\n$client = new Client();\\\\n$client-&amp;gt;setXApiKey(\\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;);\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\n$client-&amp;gt;setEnvironment(Environment::TEST);\\\\n\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\n$donationCampaignsRequest = new DonationCampaignsRequest();\\\\n$donationCampaignsRequest\\\\n  -&amp;gt;setMerchantAccount(\\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;)\\\\n  -&amp;gt;setCurrency(\\\\&amp;quot;EUR\\\\&amp;quot;)\\\\n  -&amp;gt;setLocale(\\\\&amp;quot;en-US\\\\&amp;quot;)\\\\n  -&amp;gt;setStore(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;);\\\\n\\\\n$requestOptions[&#039;idempotencyKey&#039;] = &#039;UUID&#039;;\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\n$service = new DonationsApi($client);\\\\n$response = $service-&amp;gt;donationCampaigns($donationCampaignsRequest, $requestOptions);&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;cs&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;C#&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen .NET API Library v34.0.3\\\\nusing Adyen;\\\\nusing Environment = Adyen.Model.Environment;\\\\nusing Adyen.Model;\\\\nusing Adyen.Model.Checkout;\\\\nusing Adyen.Service.Checkout;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nvar config = new Config()\\\\n{\\\\n    XApiKey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n    Environment = Environment.Test\\\\n};\\\\nvar client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nDonationCampaignsRequest donationCampaignsRequest = new DonationCampaignsRequest\\\\n{\\\\n  MerchantAccount = \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  Currency = \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  Locale = \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  Store = \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nvar service = new DonationsService(client);\\\\nvar response = service.DonationCampaigns(donationCampaignsRequest, requestOptions: new RequestOptions { IdempotencyKey = \\\\&amp;quot;UUID\\\\&amp;quot;});&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;go&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Go&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Go API Library v21.2.0\\\\nimport (\\\\n  \\\\&amp;quot;context\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/common\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/adyen\\\\&amp;quot;\\\\n  \\\\&amp;quot;github.com\\\\\\\/adyen\\\\\\\/adyen-go-api-library\\\\\\\/v21\\\\\\\/src\\\\\\\/checkout\\\\&amp;quot;\\\\n)\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nclient := adyen.NewClient(&amp;amp;common.Config{\\\\n  ApiKey:      \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  Environment: common.TestEnv,\\\\n})\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\ndonationCampaignsRequest := checkout.DonationCampaignsRequest{\\\\n  MerchantAccount: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  Currency: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  Locale: common.PtrString(\\\\&amp;quot;en-US\\\\&amp;quot;),\\\\n  Store: common.PtrString(\\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;),\\\\n}\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nservice := client.Checkout()\\\\nreq := service.DonationsApi.DonationCampaignsInput().IdempotencyKey(\\\\&amp;quot;UUID\\\\&amp;quot;).DonationCampaignsRequest(donationCampaignsRequest)\\\\nres, httpRes, err := service.DonationsApi.DonationCampaigns(context.Background(), req)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;py&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Python&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Python API Library v15.0.1\\\\nimport Adyen\\\\n\\\\nadyen = Adyen.Adyen()\\\\nadyen.client.xapikey = \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;\\\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nadyen.client.platform = \\\\&amp;quot;test\\\\&amp;quot; # The environment to use library in.\\\\n\\\\n# Create the request object(s)\\\\njson_request = {\\\\n  \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  \\\\&amp;quot;locale\\\\&amp;quot;: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.checkout.donations_api.donation_campaigns(request=json_request, idempotency_key=\\\\&amp;quot;UUID\\\\&amp;quot;)&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;rb&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;Ruby&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;# Adyen Ruby API Library v11.3.0\\\\nrequire \\\\&amp;quot;adyen-ruby-api-library\\\\&amp;quot;\\\\n\\\\nadyen = Adyen::Client.new\\\\nadyen.api_key = &#039;ADYEN_API_KEY&#039;\\\\n# For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nadyen.env = :test # Set to \\\\&amp;quot;live\\\\&amp;quot; for live environment\\\\n\\\\n# Create the request object(s)\\\\nrequest_body = {\\\\n  :merchantAccount =&amp;gt; &#039;YOUR_MERCHANT_ACCOUNT&#039;,\\\\n  :currency =&amp;gt; &#039;EUR&#039;,\\\\n  :locale =&amp;gt; &#039;en-US&#039;,\\\\n  :store =&amp;gt; &#039;USER_STORE_REFERENCE&#039;\\\\n}\\\\n\\\\n# Send the request\\\\nresult = adyen.checkout.donations_api.donation_campaigns(request_body, headers: { &#039;Idempotency-Key&#039; =&amp;gt; &#039;UUID&#039; })&amp;quot;},{&amp;quot;language&amp;quot;:&amp;quot;ts&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;NodeJS (TypeScript)&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;\\\\\\\/\\\\\\\/ Adyen Node API Library v30.1.0\\\\nimport { Client, CheckoutAPI, Types } from \\\\&amp;quot;@adyen\\\\\\\/api-library\\\\&amp;quot;;\\\\n\\\\n\\\\\\\/\\\\\\\/ For the LIVE environment, also include your liveEndpointUrlPrefix.\\\\nconst config = new Config({\\\\n  apiKey: \\\\&amp;quot;ADYEN_API_KEY\\\\&amp;quot;,\\\\n  environment: EnvironmentEnum.TEST\\\\n});\\\\n\\\\nconst client = new Client(config);\\\\n\\\\n\\\\\\\/\\\\\\\/ Create the request object(s)\\\\nconst donationCampaignsRequest: Types.checkout.DonationCampaignsRequest = {\\\\n  merchantAccount: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n  currency: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n  locale: \\\\&amp;quot;en-US\\\\&amp;quot;,\\\\n  store: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n};\\\\n\\\\n\\\\\\\/\\\\\\\/ Send the request\\\\nconst checkoutAPI = new CheckoutAPI(client);\\\\nconst response = checkoutAPI.DonationsApi.donationCampaigns(donationCampaignsRequest, { idempotencyKey: \\\\&amp;quot;UUID\\\\&amp;quot; });&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;From the response, get the details of your active donation campaign(s). You need these details &lt;a href=\\&quot;#present-option-to-donate\\&quot;&gt;to display a checkbox suggesting to round up the order amount as a donation&lt;\\\/a&gt;.&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;id&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique campaign ID of the donation campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;campaignName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The name of the donation campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;donation&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Specifies the details of the donation. This object has: &lt;ul&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;roundup&lt;\\\/strong&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;currency&lt;\\\/code&gt;: The three-character &lt;a href=\\&quot;\\\/development-resources\\\/currency-codes\\\/\\&quot;&gt;ISO currency code&lt;\\\/a&gt;.&lt;\\\/li&gt;&lt;li markdown=\\&quot;1\\&quot;&gt;&lt;code&gt;maxRoundupAmount&lt;\\\/code&gt;: Specifies the maximum amount a transaction can be rounded up to make a donation.&lt;\\\/li&gt;&lt;\\\/ul&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;causeName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The cause of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;logoUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL for the logo of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;bannerUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL for the banner of the nonprofit or campaign.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitName&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The name of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitDescription&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The description of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;nonprofitUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The website URL of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;code&gt;termsAndConditionsUrl&lt;\\\/code&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The URL of the terms and conditions page of the nonprofit.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donationCampaigns response for a round-up donation&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;bash\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;donationCampaigns\\\\\\&quot;: [\\\\n        {\\\\n            \\\\\\&quot;id\\\\\\&quot;: \\\\\\&quot;DONATION_CAMPAIGN_ID\\\\\\&quot;,\\\\n            \\\\\\&quot;campaignName\\\\\\&quot;: \\\\\\&quot;DONATION_CAMPAIGN_NAME\\\\\\&quot;,\\\\n            \\\\\\&quot;donation\\\\\\&quot;: {\\\\n                \\\\\\&quot;currency\\\\\\&quot;: \\\\\\&quot;EUR\\\\\\&quot;,\\\\n                \\\\\\&quot;type\\\\\\&quot;: \\\\\\&quot;roundup\\\\\\&quot;,\\\\n                \\\\\\&quot;maxRoundupAmount\\\\\\&quot;: 100\\\\n            },\\\\n            \\\\\\&quot;nonprofitName\\\\\\&quot;: \\\\\\&quot;NONPROFIT_NAME\\\\\\&quot;,\\\\n            \\\\\\&quot;causeName\\\\\\&quot;: \\\\\\&quot;NONPROFIT_CAUSE\\\\\\&quot;,\\\\n            \\\\\\&quot;nonprofitDescription\\\\\\&quot;: \\\\\\&quot;NONPROFIT_DESCRIPTION.\\\\\\&quot;,\\\\n            \\\\\\&quot;nonprofitUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_WEBSITE_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;logoUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_LOGO_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;bannerUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_BANNER_URL\\\\\\&quot;,\\\\n            \\\\\\&quot;termsAndConditionsUrl\\\\\\&quot;: \\\\\\&quot;NONPROFIT_TERMS_AND_CONDITIONS_URL\\\\\\&quot;\\\\n        }\\\\n    ]\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;roundup&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;roundup&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"present-option-to-donate\">Present the option to donate<\/h2>\n\n<div id=\"tabSlDXB\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Fixed amount donations&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Use the values you received in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; response to show a donation form with one or more buttons for the shopper to select a donation amount. For example, &lt;strong&gt;Donate EUR&amp;nbsp;3&lt;\\\/strong&gt;, &lt;strong&gt;Donate EUR&amp;nbsp;5&lt;\\\/strong&gt;, and &lt;strong&gt;Donate EUR&amp;nbsp;10&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;p&gt;The donation form must:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Show the name and description of the nonprofit.&lt;\\\/li&gt;\\n&lt;li&gt;Link to the nonprofit&#039;s &lt;a href=\\&quot;\\\/online-payments\\\/donations\\\/terms-and-conditions\\&quot;&gt;Terms &amp;amp; Conditions&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Show the campaign banner and logo.&lt;\\\/li&gt;\\n&lt;li&gt;Have the option for the shopper to decline to donate. For example, a &lt;strong&gt;Not now&lt;\\\/strong&gt; button.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The donation form can optionally include the cause of the nonprofit.&lt;\\\/p&gt;\\n&lt;p&gt;If the shopper paid with iDEAL, tell the shopper that the donation transaction will show up in their bank statement a day or more later.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:&quot;fixed&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;fixed&quot;},{&quot;title&quot;:&quot;Round-up donations&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;Use the values you received in the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donationCampaigns\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donationCampaigns&lt;\\\/a&gt; response to show a checkbox that suggests to round up the shopper&#039;s payment amount as a donation.&lt;\\\/p&gt;\\n&lt;p&gt;Use the following formula to calculate the round-up amount:&lt;\\\/p&gt;\\n&lt;pre&gt;&lt;code class=\\&quot;language-text\\&quot;&gt;roundupAmount = maxRoundupAmount - (commercialTxAmount % maxRoundupAmount)&lt;\\\/code&gt;&lt;\\\/pre&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;maxRoundupAmount&lt;\\\/code&gt;: The maximum amount the transaction can be rounded up, received in the &lt;code&gt;\\\/donationCampaigns&lt;\\\/code&gt; response.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;commercialTxAmount&lt;\\\/code&gt;: The original transaction amount for the shopper&#039;s order. This excludes the donation amount.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;The checkout page must:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Show the name of the nonprofit.&lt;\\\/li&gt;\\n&lt;li&gt;Link to the nonprofit&#039;s website.&lt;\\\/li&gt;\\n&lt;li&gt;Link to the nonprofit&#039;s &lt;a href=\\&quot;\\\/online-payments\\\/donations\\\/terms-and-conditions\\&quot;&gt;Terms &amp;amp; Conditions&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;If the shopper is paying with iDEAL, tell the shopper that the donation transaction will show up in their bank statement a day or more later.&lt;\\\/p&gt;\\n&quot;,&quot;altTitle&quot;:&quot;roundup&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;roundup&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"make-a-donation\">Make a donation<\/h2>\n<p>Depending on the  <a href=\"\/platforms\/online-payments\/donations-online#donation-moment\">donation moment<\/a>  for the campaign, you make a donation request at either time:<\/p>\n<ul>\n<li><strong>Pre-checkout donation<\/strong>: you first make a  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request. If the payment is authorized, and the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> or  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/details\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/details<\/a> (for iDEAL payments) response includes the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#responses-200-donationToken\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">donationToken<\/a> field, you make a donation request.<\/li>\n<li><strong>Post-checkout donation<\/strong>: you present the option to donate after the shopper completes the payment for their original transaction, you make a donation request and use the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#responses-200-donationToken\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">donationToken<\/a> you received in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> or  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\/details\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments\/details<\/a> (for iDEAL payments) response.<\/li>\n<\/ul>\n\n<div id=\"tabBbrzg\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Fixed amount donations&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donations&lt;\\\/a&gt; request, specifying the following fields:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-amount\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;amount&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The &lt;code&gt;currency&lt;\\\/code&gt; and &lt;code&gt;value&lt;\\\/code&gt; of the donation.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationCampaignId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationCampaignId&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique campaign ID from the &lt;code&gt;\\\/donationCampaigns&lt;\\\/code&gt; response &lt;code&gt;id&lt;\\\/code&gt; field.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments#request-paymentMethod\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;paymentMethod&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt; &lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;For cards, Apple Pay, or Google Pay: &lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;scheme&lt;\\\/strong&gt; &lt;br&gt; For iDEAL: &lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;sepadirectdebit&lt;\\\/strong&gt;&lt;br&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationOriginalPspReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationOriginalPspReference&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The PSP reference of the original payment.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationOriginalPspReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationToken&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;For cards, the &lt;code&gt;donationToken&lt;\\\/code&gt; from the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt;, or  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\\/details\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments\\\/details&lt;\\\/a&gt; response. &lt;br&gt; For iDEAL, the &lt;code&gt;donationToken&lt;\\\/code&gt; from the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\\/details\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments\\\/details&lt;\\\/a&gt; response.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-reference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;reference&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The reference to uniquely identify a payment. This reference is used in all communication with you about the payment status. We recommend using a unique value per payment; however, it is not a requirement. If you need to provide multiple references for a transaction, separate them with hyphens (\\&quot;-\\&quot;). Maximum length: 80 characters.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-merchantAccount\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;merchantAccount&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The merchant account identifier, with which you want to process the transaction.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-store\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;store&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your reference for the user&#039;s store.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donations request on a platform&#039;\\&quot; :id=\\&quot;&#039;make-a-donation-platform&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/checkout-test.adyen.com\\\\\\\/v72\\\\\\\/donations \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;amount\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n        \\\\&amp;quot;value\\\\&amp;quot;: 500\\\\n    },\\\\n    \\\\&amp;quot;donationCampaignId\\\\&amp;quot;: \\\\&amp;quot;DONATION_CAMPAIGN_ID\\\\&amp;quot;,\\\\n    \\\\&amp;quot;paymentMethod\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;scheme\\\\&amp;quot;\\\\n    },\\\\n    \\\\&amp;quot;donationOriginalPspReference\\\\&amp;quot;: \\\\&amp;quot;ORIGINAL_PAYMENT_PSP_REFERENCE\\\\&amp;quot;,\\\\n    \\\\&amp;quot;donationToken\\\\&amp;quot;: \\\\&amp;quot;DONATION_TOKEN\\\\&amp;quot;,\\\\n    \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;YOUR_DONATION_REFERENCE\\\\&amp;quot;,\\\\n    \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n    \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the response, note the following:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;id&lt;\\\/code&gt;: a unique resource identifier.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;status&lt;\\\/code&gt;: the status of the donation. Possible values: &lt;strong&gt;completed&lt;\\\/strong&gt;, &lt;strong&gt;pending&lt;\\\/strong&gt;, or &lt;strong&gt;refused&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;payment&lt;\\\/code&gt;: object that contains the &lt;a href=\\&quot;\\\/online-payments\\\/build-your-integration\\\/payment-result-codes\\\/#final-payment-status\\&quot;&gt;result code&lt;\\\/a&gt;, and the &lt;code&gt;pspReference&lt;\\\/code&gt; for the donation transaction.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;fixed&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;fixed&quot;},{&quot;title&quot;:&quot;Round-up donations&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a POST  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/donations&lt;\\\/a&gt; request, specifying the following fields:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Field name&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-amount\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;amount&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The &lt;code&gt;currency&lt;\\\/code&gt; and &lt;code&gt;value&lt;\\\/code&gt; of the donation.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationCampaignId\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationCampaignId&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The unique campaign ID from the &lt;code&gt;\\\/donationCampaigns&lt;\\\/code&gt; response &lt;code&gt;id&lt;\\\/code&gt; field.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments#request-paymentMethod\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;paymentMethod&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt; &lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;For cards, Apple Pay, or Google Pay: &lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;scheme&lt;\\\/strong&gt; &lt;br&gt; For iDeal: &lt;code&gt;type&lt;\\\/code&gt;: &lt;strong&gt;sepadirectdebit&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationOriginalPspReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationOriginalPspReference&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The PSP reference of the original payment.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-donationOriginalPspReference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;donationToken&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;For cards, the &lt;code&gt;donationToken&lt;\\\/code&gt; from the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments&lt;\\\/a&gt; response. &lt;br&gt; For iDeal, the &lt;code&gt;donationToken&lt;\\\/code&gt; from the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/payments\\\/details\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/payments\\\/details&lt;\\\/a&gt; response.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-reference\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;reference&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The reference to uniquely identify a payment. This reference is used in all communication with you about the payment status. We recommend using a unique value per payment; however, it is not a requirement. If you need to provide multiple references for a transaction, separate them with hyphens (\\&quot;-\\&quot;). Maximum length: 80 characters.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-merchantAccount\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;merchantAccount&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The merchant account identifier, with which you want to process the transaction.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/Checkout\\\/latest\\\/post\\\/donations#request-store\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;store&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;span class=\\&quot;hint--bottom\\&quot; data-hint=\\&quot;Required\\&quot; markdown=\\&quot;1\\&quot;&gt;&lt;img style=\\&quot;width: 25px;\\&quot; alt=\\&quot;Required\\&quot; src=\\&quot;\\\/user\\\/pages\\\/reuse\\\/image-library\\\/01.icons\\\/required\\\/required.svg?decoding=auto&amp;amp;fetchpriority=auto\\&quot; \\\/&gt;&lt;\\\/span&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;Your reference for the user&#039;s store.&lt;\\\/td&gt;\\n&lt;td&gt;&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Example POST \\\/donations request on a platform&#039;\\&quot; :id=\\&quot;&#039;make-a-donation-roundup-platform&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/checkout-test.adyen.com\\\\\\\/v72\\\\\\\/donations \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X POST \\\\\\\\\\\\n-d &#039;{\\\\n    \\\\&amp;quot;amount\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;currency\\\\&amp;quot;: \\\\&amp;quot;EUR\\\\&amp;quot;,\\\\n        \\\\&amp;quot;value\\\\&amp;quot;: 99\\\\n    },\\\\n    \\\\&amp;quot;donationCampaignId\\\\&amp;quot;: \\\\&amp;quot;DONATION_CAMPAIGN_ID\\\\&amp;quot;,\\\\n    \\\\&amp;quot;paymentMethod\\\\&amp;quot;: {\\\\n        \\\\&amp;quot;type\\\\&amp;quot;: \\\\&amp;quot;scheme\\\\&amp;quot;\\\\n    },\\\\n    \\\\&amp;quot;donationOriginalPspReference\\\\&amp;quot;: \\\\&amp;quot;ORIGINAL_PAYMENT_PSP_REFERENCE\\\\&amp;quot;,\\\\n    \\\\&amp;quot;donationToken\\\\&amp;quot;: \\\\&amp;quot;DONATION_TOKEN\\\\&amp;quot;,\\\\n    \\\\&amp;quot;reference\\\\&amp;quot;: \\\\&amp;quot;YOUR_DONATION_REFERENCE\\\\&amp;quot;\\\\n    \\\\&amp;quot;merchantAccount\\\\&amp;quot;: \\\\&amp;quot;YOUR_MERCHANT_ACCOUNT\\\\&amp;quot;,\\\\n    \\\\&amp;quot;store\\\\&amp;quot;: \\\\&amp;quot;USER_STORE_REFERENCE\\\\&amp;quot;\\\\n}&#039;&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;In the response, note the following:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;id&lt;\\\/code&gt;: a unique resource identifier.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;status&lt;\\\/code&gt;: the status of the donation. Possible values: &lt;strong&gt;completed&lt;\\\/strong&gt;, &lt;strong&gt;pending&lt;\\\/strong&gt;, or &lt;strong&gt;refused&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;payment&lt;\\\/code&gt;: object that contains the &lt;a href=\\&quot;\\\/online-payments\\\/build-your-integration\\\/payment-result-codes\\\/#final-payment-status\\&quot;&gt;result code&lt;\\\/a&gt;, and the &lt;code&gt;pspReference&lt;\\\/code&gt; for the donation transaction.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:&quot;roundup&quot;,&quot;oldTabId&quot;:1,&quot;relation&quot;:&quot;roundup&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"giving-webhook\">Get the donation outcome<\/h2>\n<p>You get the outcome of each donation in a webhook message. For cards, you can show the shopper if their donation is successful after you get the webhook message. For iDEAL, you get the webhook event a day or more later. You can send the outcome to the shopper using email or mobile messaging.<\/p>\n<p>To receive these webhook messages, enable the <a href=\"\/development-resources\/webhooks\/webhook-types#other-webhooks\">Adyen Giving merchant webhook<\/a>, which includes <code>eventCode<\/code>: <span translate=\"no\"><strong>DONATION<\/strong><\/span>.<\/p>\n<p>For a successful donation, the event contains:<\/p>\n<ul>\n<li><code>success<\/code>: <span translate=\"no\"><strong>true<\/strong><\/span>.<\/li>\n<li><code>originalReference<\/code>: use this value to associate the donation with the shopper's original transaction.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Successful donation webhook event'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n  \\\"live\\\": \\\"false\\\",\\n  \\\"notificationItems\\\": [\\n    {\\n      \\\"NotificationRequestItem\\\": {\\n        \\\"additionalData\\\": {\\n          \\\"originalMerchantAccountCode\\\": \\\"YOUR_MERCHANT_ACCOUNT\\\"\\n        },\\n        \\\"amount\\\": {\\n          \\\"currency\\\": \\\"EUR\\\",\\n          \\\"value\\\": 500\\n        },\\n        \\\"originalReference\\\": \\\"V4HZ4RBFJGXXGN82\\\",\\n        \\\"eventCode\\\": \\\"DONATION\\\",\\n        \\\"eventDate\\\": \\\"2022-07-07T13:18:13+02:00\\\",\\n        \\\"merchantAccountCode\\\": \\\"CHARITY_DONATION_ACCOUNT\\\",\\n        \\\"merchantReference\\\": \\\"YOUR_DONATION_REFERENCE\\\",\\n        \\\"paymentMethod\\\": \\\"visa\\\",\\n        \\\"pspReference\\\": \\\"Z58FGTKBRCQ2WN27\\\",\\n        \\\"reason\\\": \\\"033899:1111:03\\\/2030\\\",\\n        \\\"success\\\": \\\"true\\\"\\n      }\\n    }\\n  ]\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"test-and-go-live\">Test and go live<\/h2>\n<p>Before going live with your integration, <a href=\"\/online-payments\/donations\/testing\" target=\"_blank\">use our test cards to test your integration<\/a>.<\/p>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/platforms\/donations#campaign-lifecycle-management\"\n                        target=\"_self\"\n                        >\n                    Campaign lifecycle management\n                <\/a><\/li><li><a href=\"\/platforms\/in-person-payments\/donations\"\n                        target=\"_self\"\n                        >\n                    Giving for in-person platform payments\n                <\/a><\/li><li><a href=\"\/online-payments\/donations\/api-only\"\n                        target=\"_self\"\n                        >\n                    API-only integration\n                <\/a><\/li><li><a href=\"\/reporting\/donation-campaigns\"\n                        target=\"_self\"\n                        >\n                    Reports and dashboard\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/platforms\/online-payments\/donations-online","articleFields":{"description":"Enable your users to accept online donations from shoppers using Adyen Giving.","feedback_component":true,"parameters":{"payment_method":"Giving","payment_type":"online","model":"platform"},"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/platforms\/online-payments\/donations-online","title":"Online donations using Adyen Giving","content":"\nRead more&nbsp;Learn about Adyen Giving on your payment terminals.\n\nWith Adyen Giving, your users can give shoppers the option to donate to a nonprofit organization when shoppers make an online purchase. To enable this, you set up donation campaigns for account holder resources.\nWhen a campaign has been started and a shopper chooses to donate, the donation is processed as a separate transaction. Adyen covers all fees and the donation amount is transferred to the nonprofit in full. This means you can split amounts and fees on the original transaction, but not on the donation transaction.\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.\n\n\nCustomer Area roles\nMake sure that you 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\nWebhooks\nSubscribe to the Adyen Giving merchant webhook.\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, or pick one of our pre-approved nonprofits that have already been onboarded.\n\n\n\nHow it works\nTo enable your users to accept donations at checkout:\n\n\nChoose a nonprofit.\n\n\nSet up an account holder donation campaign in your Customer Area, under Giving &gt; Campaigns.\nYou need to select:\n\nThe account holders that you want to make the campaign available to.\nThe nonprofit.\n\nThe stores and donation settings.\n\n\n\n\n\nMake sure that your integration can show the active campaign in your checkout, and make a request for the amount that the shopper wants to donate. See Online payments flow.\n\n\nMake sure you have a way to show the nonprofit's terms and conditions.\n\n\nTo inform shoppers about their donation, make sure that you can process Giving webhook messages.\n\n\nStart the campaign from the Campaigns overview in your Customer Area.\n\n\nDonation settings\nWith our Giving integration, you have the flexibility to choose a combination of donation type and donation moment.\nHowever, there are limitations to the supported choices, depending on region and currency and payment method.\nDonation type\nIn your donation campaign you can configure the following donation types:\n\nFixed amounts: up to three fixed amounts to present to shoppers when they make a payment. Your checkout should provide a selection mechanism, such as donation buttons for these amounts.\nRound up: allow shoppers to donate by rounding up the transaction amount of their purchase. Your checkout should show a round-up checkbox. We recommend rounding up to the nearest whole amount.\n\nDonation moment\nYour integration can present the option to donate at different moments in your checkout flow:\n\nPre-checkout: the shopper can review the total transaction amount that includes the donation before completing their payment.\nPost-checkout: the shopper can contribute to your donation campaign after completing their payment. This gives you flexibility to align Giving with your existing checkout process.\n\nSet up a donation campaign for account holders\nThe Campaigns user interface in the Customer Area guides you through setting up a donation campaign, and shows example screens. The main steps to create an Adyen Giving donation campaign for your account holders are as follows:\n\n\nIn your Customer Area, go to Giving &gt; Campaigns.\n\n\nSelect Create new campaign &gt; For account holders.\n\n\nAdd the account holders to the campaign, one by one or as a group:\n\nOne by one: select Search accounts, select your balance platform, and search by account holder ID or reference, legal entity ID or name, or email address. Then select Add in the tile of the individual account holder.\nGroup: select Submit a list of accounts, select your balance platform, enter a comma-separated list of account holder IDs, and select Add.\n\nThe UI will inform you if an account holder has already been added or cannot be found on the selected balance platform.\n\n\nSelect the campaign details:\n\nThe nonprofit.\nEither a specific cause, or \"General fundraising\".\n\nThe sales channel: online payments (ecommerce), in-person payments (point of sale), or both.\n\n\n\n\n\nIf you selected online payments, first select the stores that the campaign applies to.\nThen select the donation type. When you choose fixed amounts and enter the amounts in your default currency, we automatically add equivalent amounts in other currencies if necessary for the selected stores.\n\n\nIf you selected in-person payments, first select the stores that the campaign applies to.\nThen  refer to in-person donation settings, and  select:\n\nThe one-step or two-step interaction flow.\nTimeouts for the donation prompt and the payment screen.\nThe text to show on the donation screen on the terminal: the name of the nonprofit or the cause you selected.\n\nThe donation type. When you choose fixed amounts and enter the amounts in your default currency, we automatically add equivalent amounts in other currencies if necessary for the selected stores.\n\n\n\n\n\nReview the summary. When everything is correct, select Create campaign.\n\n\nThe campaign is now set up, but not active yet.\nWhen you are ready to activate the campaign:\n\nIn your Customer Area, go to Giving &gt; Campaigns.\nFind the tile for the campaign, and select Start.\n\nOnline payments flow\nThe donation flow depends on the donation moment:\n\n\n    \n        \n        \n    \n\n\nGet details of your active donation campaigns\nDepending on the donation moment that you choose, get the details of your active donation campaigns at either moment:\n\nWhen a shopper proceeds to pay for their original transaction with a payment method that supports donations.\nWhen a shopper completes their original transaction with a payment method that supports donations, and the  \/payments or  \/payments\/details (for iDEAL payments) response includes the  donationToken field.\n\nWhen you make a request to get your active donation campaigns, the response you receive depends on your donation type:\n\n\n    \n        \n        \n    \n\n\nPresent the option to donate\n\n\n    \n        \n        \n    \n\n\nMake a donation\nDepending on the  donation moment  for the campaign, you make a donation request at either time:\n\nPre-checkout donation: you first make a  \/payments request. If the payment is authorized, and the  \/payments or  \/payments\/details (for iDEAL payments) response includes the  donationToken field, you make a donation request.\nPost-checkout donation: you present the option to donate after the shopper completes the payment for their original transaction, you make a donation request and use the  donationToken you received in the  \/payments or  \/payments\/details (for iDEAL payments) response.\n\n\n\n    \n        \n        \n    \n\n\nGet the donation outcome\nYou get the outcome of each donation in a webhook message. For cards, you can show the shopper if their donation is successful after you get the webhook message. For iDEAL, you get the webhook event a day or more later. You can send the outcome to the shopper using email or mobile messaging.\nTo receive these webhook messages, enable the Adyen Giving merchant webhook, which includes eventCode: DONATION.\nFor a successful donation, the event contains:\n\nsuccess: true.\noriginalReference: use this value to associate the donation with the shopper's original transaction.\n\n\n    \n\nTest and go live\nBefore going live with your integration, use our test cards to test your integration.\nSee also\n\n\n                    Campaign lifecycle management\n                \n                    Giving for in-person platform payments\n                \n                    API-only integration\n                \n                    Reports and dashboard\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Process online payments","lvl3":"Online donations using Adyen Giving"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/platforms","lvl2":"https:\/\/docs.adyen.com\/platforms\/online-payments","lvl3":"\/platforms\/online-payments\/donations-online"},"levels":4,"category":"Platforms","category_color":"green","tags":["Online","donations","using","Adyen","Giving"]},"articleFiles":{"giving.svg":"<img style=\"width: 28px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.platforms\/27.online-payments\/06.donations-online\/giving.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}
