Test your Giving integration

Before 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:

1. Creating and activating a donation campaign.
2. Making a donation.
3. Getting the donation outcome in the Adyen Giving merchant webhook.

Test environment

Create and activate a test donation campaign

1. In your test Customer Area, go to Giving > Campaigns.
2. Create a test campaign using one of our demo nonprofits.
3. Select Start campaign for the campaign you configured to:
   • Activate the campaign.
   • Start receiving the donationToken in the /payments or /payments/details responses.

Make a test donation

After you have started a campaign, verify that the /payments or /payments/details response contains a donationToken.

When you make a /donationCampaigns request, verify that the details returned in the response are correct.

Using your integration, make test donations using our test cards.

Get the test donation outcome

For each test donation that you make, verify that you get a DONATION webhook.

Live environment

Create and activate a live donation campaign

1. In your Live Customer Area, go to Giving > Campaigns.

   If you do not see Giving section in your Customer Area, reach out to your Adyen contact or our Support Team.

2. Create a campaign for your nonprofit.
3. Select Start campaign for the campaign you configured to:
   • Activate the campaign.
   • Start receiving the donationToken in the /payments or /payments/details responses.

Enable the webhook for the live environment

In your live Customer Area, enable the Adyen Giving merchant webhook.

Make donations for your live campaign

After you have started a campaign, verify that the /payments or /payments/details response contains a donationToken.

When you make a /donationCampaigns request, verify that the details returned in the response are correct.

Using your integration, make a donation to your nonprofit.

Get the donation outcome

You can verify the outcome of the donation by either:

• Getting the DONATION webhook for your donation.
• Finding the donation in a Giving report or dashboard.

Troubleshooting

If an issue occurs with your test donation requests, you can find more details in the API logs.

Test cards for donations

You can use the test card details below to make test donations.

The following test card doesn't require the CVC when entering the card details. You must use this card to test Visa payments.

Test 3D Secure 2 authentication with donations

The following test cards are enrolled in 3D Secure 2.

The following test card has TRA exemption. In your payment request, include threeDSRequestorChallengeInd: "05".

See also