\n| 4871 0499 9999 9910<\/td>\n | Bancontact<\/td>\n | BE<\/td>\n | 03\/2030<\/td>\n | 737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n The following test card doesn't require the CVC when entering the card details. You must use this card to test Visa payments.<\/p>\n \n\n\n| Card Number<\/th>\n | Card Type<\/th>\n | Issuing Country\/region<\/th>\n | Expiry Date<\/th>\n | CVC<\/th>\n<\/tr>\n<\/thead>\n | \n\n| 4111 1111 4555 1142<\/td>\n | Visa<\/td>\n | NL<\/td>\n | 03\/2030<\/td>\n | 737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nTest 3D Secure 2 authentication with donations<\/h3>\nThe following test cards are enrolled in 3D Secure 2.<\/p>\n \n\n\n| Card Number<\/th>\n | Card Type<\/th>\n | Issuing Country\/region<\/th>\n | Expiry Date<\/th>\n | CVC<\/th>\n<\/tr>\n<\/thead>\n | \n\n| 3714 4963 5398 431<\/td>\n | American Express<\/td>\n | US<\/td>\n | 03\/2030<\/td>\n | 7373<\/td>\n<\/tr>\n | \n| 6011 1111 1111 1117<\/td>\n | Discover<\/td>\n | US<\/td>\n | 03\/2030<\/td>\n | 737<\/td>\n<\/tr>\n | \n| 5111 1200 3000 8958<\/td>\n | Mastercard<\/td>\n | NL<\/td>\n | 03\/2030<\/td>\n | 737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/standard\/integration\/drop-in\/donations","articleFields":{"description":"Accept donations with the Adyen Giving feature in your Drop-in integration."},"algolia":{"url":"https:\/\/docs.adyen.com\/standard\/integration\/drop-in\/donations","title":"Donations","content":"Adyen Giving is our donations feature. It lets your shoppers donate to a nonprofit as part of your payment flow. If the shopper chooses to make a donation, the donation amount is charged to the same payment method that was used for the original transaction. Drop-in handles the donation flow, including showing the donation campaign and processing the donation. \nRequirements\nIn addition to the general Adyen Giving requirements, take into account the following requirements.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA standard payments integration with Drop-in.\n\n\nCustomer Area roles\nMake sure that you have the Donation campaigns manager role.\n\n\nWebhooks\nSubscribe to the following webhooks: Standard webhooksAdyen Giving merchant webhook\n\n\nSetup steps\nBefore you begin: Make sure you meet all the requirements for Adyen Giving.\n\n\n\nHow it works\n\nThe shopper goes to the checkout page.\nYour server creates a payment session. You do not need to pass any donation-specific parameters in your request to create a payment session.\nWhen you create a global configuration object for AdyenCheckout, optionally add a configuration object for donations.\nDrop-in shows the payment form.\nThe shopper submits the payment on your checkout page.\nDrop-in handles the payment flow.\nIf the payment is successful, Drop-in checks if you have an active donation campaign in your Adyen Customer Area.\nIf you have an active donation campaign, Drop-in shows the donation form.\nThe shopper chooses to donate or declines.\nDrop-in handles the donation flow.\nGet the donation result from the donation.onDonationSuccess callback.\nAdyen sends a webhook message with the donation outcome.\nAdyen sends a webhook message with the payment outcome.\n\nCnNlcXVlbmNlRGlhZ3JhbQogICAgcGFydGljaXBhbnQgUyBhcyBTaG9wcGVyCiAgICBwYXJ0aWNpcGFudCBGIGFzIFlvdXIgY2xpZW50IHdlYnNpdGUKICAgIHBhcnRpY2lwYW50IFNWIGFzIFlvdXIgc2VydmVyCiAgICBwYXJ0aWNpcGFudCBBIGFzIEFkeWVuCiAgICBwYXJ0aWNpcGFudCBXIGFzIFlvdXIgd2ViaG9vayBzZXJ2ZXIKCiAgICBTLT4+RjogMS4gR28gdG8gY2hlY2tvdXQgcGFnZQogICAgU1YtPj5BOiAyLiBDcmVhdGUgcGF5bWVudCBzZXNzaW9uCiAgICBBLS0+PlNWOiBSZXR1cm4gc2Vzc2lvbiBkYXRhCiAgICBTVi0tPj5GOiBQYXNzIHNlc3Npb24gZGF0YQogICAgTm90ZSBvdmVyIEY6IDMuIEFkZCBvcHRpb25hbCBkb25hdGlvbiBjb25maWd1cmF0aW9uIGFuZCBpbml0aWFsaXplIERyb3AtaW4KICAgIEYtPj5TOiA0LiBEcm9wLWluIHNob3dzIHBheW1lbnQgZm9ybQogICAgUy0+PkY6IDUuIFN1Ym1pdCBwYXltZW50CiAgICBOb3RlIG92ZXIgRjogNi4gRHJvcC1pbiBoYW5kbGVzIHBheW1lbnQgZmxvdwogICAgRi0+PkE6IERyb3AtaW4gc2VuZHMgcGF5bWVudCBkYXRhCiAgICBOb3RlIG92ZXIgQTogNy4gQ2hlY2sgZm9yIGFjdGl2ZSBkb25hdGlvbiBjYW1wYWlnbgogICAgQS0tPj5GOiBTZXNzaW9uIHJlc3VsdCBhbmQgZG9uYXRpb24gY2FtcGFpZ24gZGF0YQogICAgb3B0IElmIHlvdSBoYXZlIGFjdGl2ZSBkb25hdGlvbiBjYW1wYWlnbgogICAgICAgIEYtPj5TOiA4LiBEcm9wLWluIHNob3dzIGRvbmF0aW9uIGZvcm0KICAgICAgICBTLT4+RjogOS4gRG9uYXRlIG9yIGRlY2xpbmUKICAgICAgICBOb3RlIG92ZXIgRjogMTAuIERyb3AtaW4gaGFuZGxlcyBkb25hdGlvbiBmbG93CiAgICAgICAgRi0+PkE6IERyb3AtaW4gc2VuZHMgZG9uYXRpb24gZGF0YQogICAgICAgIEEtLT4+RjogMTEuIERvbmF0aW9uIHJlc3VsdCAKICAgICAgICBBLT4+VzogMTIuIFdlYmhvb2sgbWVzc2FnZSB3aXRoIGRvbmF0aW9uIG91dGNvbWUKICAgIGVuZAogICAgQS0+Plc6IDEzLiBXZWJob29rIG1lc3NhZ2Ugd2l0aCBwYXltZW50IG91dGNvbWUgCg==\nAdd Giving configuration\nWhen you create a global configuration object for Drop-in, you add configuration for donations to enable the feature.\nEvent handlers:\n\n\n\nProperty\nRequired\nDescription\n\n\n\n\nonDonationSuccess\n\nCalled when the donation is completed or the shopper declines to donate. Receives an object with didDonate: true or false.\n\n\nonDonationFailure\n\nCalled when an error occurs in the donation creation or when a donation fails.\n\n\n\nConfiguration parameters:\n\n\n\nProperty\nRequired\nDescription\n\n\n\n\nautoMount\n\nSpecifies if Drop-in automatically shows the donation form after a successful payment. Set to false to not show the donation form after the payment is completed. Default: true.\n\n\ndelay\n\nThe delay in milliseconds after a successful payment before Drop-in shows the donation form.\n\n\n\n\n \n\nAfter a successful payment, if you have an active donation campaign configured, Drop-in shows the donation form. By default, the donation form is mounted in the same container as Drop-in.\nDrop-in handles the full donation flow, including:\n\nShowing the donation campaign details (nonprofit name, description, logo, and banner).\nShowing the donation amount options.\nProcessing the donation.\n\nGet the donation outcome\nAfter Drop-in finishes the payment flow, you can inform the shopper about the current payment status. \nInform the shopper\nDepending on whether the donation was successful, the onDonationSuccess or onDonationFailure event is triggered. From the relevant event, you can get the result object to inform the shopper.\nGet the webhook message\nYou also get the outcome of each donation in a webhook message. \nFor a successful donation, the event contains:\n\n\n\nField\nDescription\n\n\n\n\neventCode\nDONATION\n\n\nsuccess\ntrue\n\n\noriginalReference\nUse this value to associate the donation with the shopper's original transaction.\n\n\n\n\n \n\nTest and go live\nBefore you go live with donations, test your integration to make sure that your nonprofit receives the donations from your shoppers. We recommend to test your integration in the test environment, and live environment. In each environment, test the following:\n\nCreating and activating a donation campaign.\nMaking a donation.\nGetting the donation outcome in the webhook message (Adyen Giving merchant webhook).\n\nTest environment\nCreate and activate a test donation campaign\n\nIn your test Customer Area, go to Giving > Campaigns.\nCreate a test campaign using one of our demo nonprofits.\nSelect Start campaign for the campaign you configured to:\n\nActivate the campaign.\nStart receiving the donationToken in the \/payments or \/payments\/details responses.\n\n\nMake a test donation\n\nTo test donations using iDEAL, contact our Support Team for additional configuration.\n\nAfter you have started a campaign, verify that the \/payments or \/payments\/details response contains a donationToken.\nWhen you make a \/donationCampaigns request, verify that the details returned in the response are correct.\nUsing your integration, make test donations using our test cards.\nGet the test donation outcome\nFor each test donation that you make, verify that you get a webhook message.\nLive environment\nCreate and activate a live donation campaign\n\nIn your Live Customer Area, go to Giving > Campaigns.\n\nIf you do not see Giving section in your Customer Area, reach out to your Adyen contact or our Support Team.\n\nCreate a campaign for your nonprofit.\nSelect Start campaign for the campaign you configured to:\n\nActivate the campaign.\nStart receiving the donationToken in the \/payments or \/payments\/details responses.\n\n\nEnable the webhook for the live environment\nIn your live Customer Area, enable the Adyen Giving merchant webhook.\nMake donations for your live campaign\nAfter you have started a campaign, verify that the \/payments or \/payments\/details response contains a donationToken.\nWhen you make a \/donationCampaigns request, verify that the details returned in the response are correct.\nUsing your integration, make a donation to your nonprofit.\nGet the donation outcome\nYou can verify the outcome of the donation by either:\n\nGetting the webhook message for your donation.\nFinding the donation in a Giving report or dashboard.\n\nTroubleshooting\nIf an issue occurs with your test donation requests, you can find more details in the API logs.\nTest cards for donations\nYou can use the test card details below to make test donations.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n3700 0000 0000 002\nAmerican Express\nNL\n03\/2030\n7373\n\n\n3700 0000 0100 018\nAmerican Express\nNL\n03\/2030\n7373\n\n\n5555 3412 4444 1115\nMastercard Consumer\nNL\n03\/2030\n737\n\n\n5201 2820 5004 2993\nMastercard\nRU\n03\/2030\n737\n\n\n5454 5464 9832 4682\nMastercard\nPL\n03\/2030\n737\n\n\n2223 5204 4356 0010\nMastercard Debit\nNL\n03\/2030\n737\n\n\n5103 2219 1119 9245\nMastercard Prepaid\nBR\n03\/2030\n737\n\n\n3569 9900 1009 5841\nJCB\nUS\n03\/2030\n737\n\n\n6011 6011 6011 6611\nDiscover\nUS\n03\/2030\n737\n\n\n6445 6445 6445 6445\nDiscover\nGB\n03\/2030\n737\n\n\n6445 6445 6445 6445\nCarte Bancaire\nFR\n03\/2030\n737\n\n\n4871 0499 9999 9910\nBancontact\nBE\n03\/2030\n737\n\n\n\nThe following test card doesn't require the CVC when entering the card details. You must use this card to test Visa payments.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n4111 1111 4555 1142\nVisa\nNL\n03\/2030\n737\n\n\n\nTest 3D Secure 2 authentication with donations\nThe following test cards are enrolled in 3D Secure 2.\n\n\n\nCard Number\nCard Type\nIssuing Country\/region\nExpiry Date\nCVC\n\n\n\n\n3714 4963 5398 431\nAmerican Express\nUS\n03\/2030\n7373\n\n\n6011 1111 1111 1117\nDiscover\nUS\n03\/2030\n737\n\n\n5111 1200 3000 8958\nMastercard\nNL\n03\/2030\n737\n\n\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Standard payments integration","lvl2":"Build your integration","lvl3":"Drop-in","lvl4":"Donations"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/standard","lvl2":"https:\/\/docs.adyen.com\/standard\/integration","lvl3":"https:\/\/docs.adyen.com\/standard\/integration\/drop-in","lvl4":"\/standard\/integration\/drop-in\/donations"},"levels":5,"category":"","category_color":"","tags":["Donations"]}}
| | |
![\"Required\"](\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&fetchpriority=auto\")
<\/span><\/td>\n