Giving for API only

After the shopper completes their payment for the original transaction:

1. Show the shopper a donation form.
2. From your server, make a /donations request to make a donation.
3. Get the outcome from a webhook and show it to the shopper.

The following diagram shows the donation flow after the shopper finishes their original payment:

Step 1: Show a donation form

Before you show the option to donate, the shopper must make a payment with a payment method that supports donations. If their payment is successful, show the shopper a donation form.

Show a donation form with either:

• A field for the shopper to enter a donation amount.
• Buttons for the shopper to select a donation amount. For example, Donate €3, Donate €5, and Donate €10.

The donation form must:

• Show the name of the nonprofit, and some information about them.
• Link to the nonprofit's Privacy Policy and Terms & Conditions.
• Have the option for the shopper to decline to donate. For example, a Not now button.
• Tell the shopper that two different transactions will show up in their bank statement: one for the purchase (paid to your account) and another for the donation (paid to the nonprofit is account).

If the shopper paid with iDeal and chooses to donate:

• Tell the shopper that the donation is a SEPA Direct Debit from the bank account associated with their iDeal payment and get their consent to process the donation.
• Tell the shopper that the donation transaction will show up in their bank statement a day or more later.

When the shopper goes to the checkout page:

1. Show the shopper a donation form.
2. From your server, make a /payments request to make the payment for the original transaction.
3. After you get the /payments response, make a /donations request to make a donation.
4. Get the outcome from a webhook and show it to the shopper.

The following diagram shows the donation flow:

Step 1: Show a donation form

Show the donation form when the shopper checks out, before you make the /payments request for the original transaction. For example, on the payment form, show a check box under the total amount to add a fixed amount as a donation.

On the donation form, show either:

• A field for the shopper to enter a donation amount.
• Buttons for the shopper to select a donation amount. For example, Donate €3, Donate €5, and Donate €10.

The donation form must:

• Show the name of the nonprofit, and some information about them.
• Link to the nonprofit is Privacy Policy and Terms & Conditions.
• Have the option for the shopper to decline to donate. For example, a checkbox that the shopper checks to donate or a Not now button.
• Tell the shopper that two different transactions will show up in their bank statement: one for the purchase (paid to your account) and another for the donation (paid to the nonprofit is account).

If the shopper paid with iDeal and chooses to donate:

• Tell the shopper that the donation is a SEPA Direct Debit from the bank account associated with their iDeal payment and get their consent to process the donation.
• Tell the shopper that the donation transaction will show up in their bank statement a day or more later.

After the shopper selects a donation amount and selects the Pay button:

1. You make the /payments request for the original transaction amount.
2. Continue to the next step, where you make the /donations request for the donation amount.

From your server, make a POST request to /donations, specifying:

Field name	Required	Description
paymentMethod		For cards, type: scheme. For iDeal, type: sepadirectdebit.
amount		The currency and value of the donation.
donationAccount		The Adyen account name of your nonprofit. For testing, use MyCharity_Giving_TEST. For accepting live donations, use the account name that we give you after choosing your nonprofit.
donationOriginalPspReference		The PSP reference of the original payment.
donationToken		For cards, the donationToken from the /payments response. For iDeal, the donationToken from the /payments/details response.

From your server, make a POST request to /donations specifying:

Field name	Required	Description
paymentMethod		For cards, type: scheme. For iDeal, type: sepadirectdebit.
amount		The currency and value of the donation.
donationAccount		The Adyen account name of your nonprofit. For testing, use MyCharity_Giving_TEST. For accepting live donations, use the account name that we give you after choosing your nonprofit.
donationOriginalPspReference		The PSP reference of the original payment.
paymentMethod.storedPaymentMethodId		Your reference for the shopper's stored payment method.
recurringProcessingModel		CardOnFile
shopperInteraction		ContAuth