---
title: "Create a donation"
method: POST
path: "/donate"
tags: ["Modifications"]
deprecated: true
---

# Create a donation

`POST /donate`

## Request

- Base URL: `https://pal-test.adyen.com/pal/servlet/Payment/v51`
- URL: `https://pal-test.adyen.com/pal/servlet/Payment/v51/donate`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

> **Deprecated.**

Schedules a new payment to be created (including a new authorisation request) for the specified donation using the payment details of the original payment.

> This endpoint is [inactive](https://docs.adyen.com/online-payments/upgrade-your-integration#checkout-api-lifecycle) and is no longer supported for new integrations.
> * If you are building a new integration, use the Checkout API [`/donations`](https://docs.adyen.com/api-explorer/Checkout/latest/post/donations) endpoint instead.
> * If you have an existing integration using this endpoint, reach out to your Adyen contact and [migrate to the Checkout API](https://docs.adyen.com/online-payments/upgrade-your-integration/migrate-to-checkout-api).

> The Checkout API enables your [online payments](https://docs.adyen.com/online-payments) integration to accept all supported payment methods, use the latest features, and access more benefits.

## Request body

- DonationRequest
  - `donationAccount` string, required: The Adyen account name of the charity.
  - `merchantAccount` string, required: The merchant account that is used to process the payment.
  - `modificationAmount` Amount, required
    - `currency` string, required: The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required: The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `originalReference` string: The original pspReference of the payment to modify. This reference is returned in: * authorisation response * authorisation notification
  - `reference` string: Your reference for the payment modification. This reference is visible in Customer Area and in reports. Maximum length: 80 characters.

## Response `200`

OK - the request has succeeded.

- ModificationResult
  - `additionalData` object: This field contains additional data, which may be returned in a particular modification response.
  - `pspReference` string, required: Adyen's 16-character string reference associated with the transaction/request. This value is globally unique; quote it when communicating with us about this request.
  - `response` '[capture-received]' | '[cancel-received]' | '[refund-received]' | '[cancelOrRefund-received]' | '[adjustAuthorisation-received]' | '[donation-received]' | '[technical-cancel-received]' | '[voidPendingRefund-received]' | 'Authorised' | 'Refused' | 'Error', required: Indicates if the modification request has been received for processing.

## Other responses

- `400`: Bad Request - a problem reading or understanding the request.
- `401`: Unauthorized - authentication required.
- `403`: Forbidden - insufficient permissions to process the request.
- `422`: Unprocessable Entity - a request validation error.
- `500`: Internal Server Error - the server could not process the request.

## Changes

- **2026-02-17** (v51) `384b6a469631`: 2 warning
  - added the new `Error` enum value to the `response` response property for the response status `200`
  - added the new `Refused` enum value to the `response` response property for the response status `200`
- **2024-10-21** (v51) `6fbdb969f16a`: 1 warning
  - added the new `Authorised` enum value to the `response` response property for the response status `200`
- **2024-03-05** (v51) `aed9d7475d07`: 1 info
  - endpoint deprecated

[Operation history](https://skmtc.dev/adyen/apis/paymentservice/changes/donate/post.md)

---

[API](https://skmtc.dev/adyen/apis/paymentservice.md) - [All operations](https://skmtc.dev/adyen/apis/paymentservice/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/paymentservice/revisions/d04f8c1492a1?raw)