Donations using Giving

With Giving, you can give your shoppers the option to donate to a nonprofit organization after they made a purchase in your store.

Before the nonprofit can receive donations, they need to be onboarded and Giving needs to be configured. The payment terminal will then prompt for a donation either:

• Automatically after every payment. This is possible with all integrations and with standalone terminals.
• Through your payment request, so that you have control over when to ask for a donation. This is possible with a Terminal API integration.

Donations can be made using many popular payment methods, and are settled directly to the nonprofit's bank account.

Donation amount options and results

You can present the following donation options to the shopper on the payment terminal screen:

• Fixed amounts: configure up to three fixed amounts to present to your customers.
• Round-up: this option lets shoppers donate by rounding up the transaction amount of their purchase. You can enable the round-up feature on its own, or together with one fixed amount.

To be informed about your customers' donations, you can get the outcome of each donation in an Adyen Giving merchant webhook.

How it works

Regardless of whether a donation is prompted automatically after every payment or through your payment request, you can choose between a single or a double step donation flow. Double tap flow is the default interaction for donations.

Double tap flow

1. You initiate a payment for the goods your shopper is purchasing.
2. The shopper presents their card on the payment terminal and completes the payment.
3. The terminal screen shows that the payment is Approved and presents the options to donate.

   The terminal doesn't prompt for a donation when it is offline or after a gift card payment.

4. If the shopper chooses to donate, the terminal starts a new transaction (the donation) for the amount the shopper specified asking for the card to be presented.
   If the shopper chooses Not now, the flow stops.
5. The shopper completes the donation transaction.

Single tap flow

1. You initiate a payment for the goods your shopper is purchasing.

2. The shopper presents their card on the payment terminal and completes the payment.

3. The terminal presents the options to donate to the nonprofit.

   The terminal doesn't prompt for a donation when it is offline or after a gift card payment.

4. If the shopper chooses to donate, the terminal processes the donation.
   If the shopper selects Not now, the donation flow stops.

5. The terminal screen shows that the initial purchase is Approved.

Before you begin

Giving is supported with Terminal API and Classic integrations and also with standalone terminals.

Below is an overview of the supported terminals, donation options, shopper interaction flow, and payment methods.

Terminals and supported options

The following table shows the payment terminal models that support Giving, and the donation options that are supported on those terminals. The payment terminals must be on software version 1.106 or later.

Model	Fixed amounts	Round up	Double tap	Single tap
AMS1
e280
e285p
M400
P400 Plus
S1E
S1E2L
S1F2
S1U2
V240m Plus
V400c Plus
V400m

Supported payment methods

In-store donations are supported for the following payment methods:

• Credit and debit cards: American Express, Bancontact, Cartes Bancaires, Diners, Discover, JCB, Mastercard (Maestro), UnionPay, Visa, Visa Debit.
• Wallets: Apple Pay and Google Pay.

  The single tap donations flow is not supported for Bancontact and Maestro.

Onboarding with Giving

Before your nonprofit can receive donations, they need to be onboarded with Giving.

To begin the onboarding process, contact your Adyen Account Manager or our Support Team. They will handle the onboarding with the nonprofit. The nonprofit will get their own Customer Area account, where they can see an overview of donations, and handle any refunds and chargebacks.

Configure Giving

When the nonprofit is onboarded:

1. Contact your Adyen Account Manager or our Support Team to:

   • Create a donation campaign for your selected nonprofit organization.
   • Optionally, enable the single tap flow.

2. In your Customer Area go to Giving > Campaigns to configure the details of your campaign. This includes the participating merchant accounts, the donation options, the campaign text on the terminal display, card tap flow, and screen timeouts. Select Save when you are done.

3. Select Start to activate your campaign. The campaign is live on your payment terminals after the next scheduled reboot at the restart hour (at 06:00 AM by default). It is possible to change the restart hour.

4. Optionally, configure your terminal's standby screen to show a logo for your donation campaign. Follow the instructions in the Customer Area under In-person payments > Terminal Settings > Customisation > Logo.

Configure a logo for the terminal screen

Ask for a donation through a payment request

If Giving is configured to prompt for a donation through your payment request instead of automatically, you can use the tender option AskGiving in your Terminal API payment request to control when the shopper is asked for a donation.

To ensure that the terminal prompts the shopper for a donation after their payment:

1. Make a PaymentRequest that contains a SaletoAcquirerData field with the tender option AskGiving specified in one of the following formats:

   • Option 1: A JSON object {"tenderOption": "AskGiving"} converted to a Base64 encoded string:
     "SaleToAcquirerData": "eyJ0ZW5kZXJPcHRpb24iOiAiQXNrR2l2aW5nIn0="

   • Option 2: tenderOption=AskGiving:
     "SaleToAcquirerData": "tenderOption=AskGiving"

   The format that you use here will also be the format of the AdditionalResponse that you receive.

   If there are more tender options and other data elements that you need to pass in the SaleToAcquirerData field, see Add information to a payment for instructions.

2. In the response, note the AdditionalResponse data which you can use in a subsequent TransactionStatusRequest to retrieve the donation response:

   • adyen_giving_sale_id: the donation sale ID, which is fixed to AdyenGiving.
   • adyen_giving_service_id: the donation service ID. For example, 8ha5925831.

   Other than the above AdditionalResponse data, the payment response is the same as the response you receive for an approved payment without AskGiving tender option. The payment response contains no details of the donation, because the donation is a separate transaction that is initiated by the terminal instead or by your POS app.

Retrieve the donation response

In a Terminal API integration, you can retrieve the donation result through a transaction status request. You can do this regardless of whether you automatically prompt for a donation after every payment, or prompt for a donation through your payment request.

The transaction status request returns the response of the donation transaction, including a PaymentReceipt object that you can use to generate a shopper receipt for the donation.

1. To start a TransactionStatusRequest , make a POST request to a Terminal API endpoint, specifying:

   • MessageHeader: the standard SaleToPOIRequest.MessageHeader object. Specify:

     Parameter	Required	Description
     ProtocolVersion		3.0
     MessageClass		Service
     MessageCategory		TransactionStatus
     MessageType		Request
     SaleID		Your unique ID for the POS system component to send this request from.
     ServiceID		Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.
     POIID		The unique ID of the terminal to send this request to. Format: [device model]-[serial number].

   • TransactionStatusRequest: the request body with:

     • ReceiptReprintFlag: true

     • DocumentQualifier: receipt data you want to receive in the response. Can be one or both of:

       • CashierReceipt: cashier receipt, including signature data.

       • CustomerReceipt: shopper receipt.

     • MessageReference: this object identifies what you want to receive:

       Parameter	Description
       MessageCategory	Payment.
       SaleID	AdyenGiving. If you specify this SaleID and omit the ServiceID, you will get the response for the latest donation made on the terminal that you route the transaction status request to.
       ServiceID	The adyen_giving_service_id from the original payment response. This parameter returns the response for a specific donation.

   The example below shows how to check the status of a donation with the adyen_giving_service_id 8ha5925831.

2. In the TransactionStatusResponse , note the RepeatedMessageResponse. This contains the response for the donation transaction.

Receive the Giving webhook

You get the donation outcome of each donation in a webhook. To receive these webhooks, enable the Adyen Giving merchant webhook, which includes eventCode: DONATION.

For a successful donation, the event contains success: true.

Use the originalReference to associate the donation to the shopper's original transaction.

To generate a shopper receipt for the donation, retrieve the donation response, using a TransactionStatusRequest.

See also