> **Description:** Chronological history of updates, improvements, and changes made to the Donations API, helping you stay informed about new features and modifications.

# Changelog

All notable changes to the current API will be documented here.
To learn about API versioning, see
[API lifecycle](https://developer.vippsmobilepay.com/docs/knowledge-base/api-lifecycle.md).

Changes that affect multiple APIs are documented in the [general changelog](https://developer.vippsmobilepay.com/docs/changelog.md).

## May 2026

### Partner support

Partners can now call the Donations API. This also covers donations webhook registration via the Webhooks API.
See [Partner-specific behavior](https://developer.vippsmobilepay.com/docs/APIs/donations-api/api-guide.md#get-a-list-of-donation-payments) and [Partner webhooks](https://developer.vippsmobilepay.com/docs/APIs/webhooks-api/api-guide.md#partner-and-psp-webhooks).

## March 2026

### Merchant agreement stop endpoint

Added endpoint [`POST:/donations/v1/agreements/{agreementId}/stop`](https://developer.vippsmobilepay.com/redocusaurus/donations-swagger-id.yaml) so merchants can stop donation agreements.

## February 2026

### New agreement webhook events

Added two new webhook event types for donation agreement changes:

- `donations.agreement.withdrawal-day-changed.v1` - Triggered when the withdrawal day of a donation agreement is changed
- `donations.agreement.amount-changed.v1` - Triggered when the amount of a donation agreement is changed

Payload schemas and examples are documented in the [API guide: Agreement webhook payloads](https://developer.vippsmobilepay.com/docs/APIs/donations-api/api-guide.md#agreement-webhook-payloads).

## January 2026

### Webhook support and agreement details endpoint

Added webhook support for donation agreements with two new event types:

- `donations.agreement.started.v1` - Triggered when a donation agreement is started
- `donations.agreement.stopped.v1` - Triggered when a donation agreement is stopped

Added new endpoint [`GET:/donations/v1/agreements/{agreementId}`](https://developer.vippsmobilepay.com/redocusaurus/donations-swagger-id.yaml) to retrieve comprehensive details about a specific donation agreement

See [API guide: Webhooks integration](https://developer.vippsmobilepay.com/docs/APIs/donations-api/api-guide.md#webhooks-integration) for more details.

### Authentication changes

The Donations product was released. This changes how authentication is done for new integrations.

We have added *merchant level API clients*, and they are in use on the Donations API.

This means you will get a client ID and a client secret in the portal, and you will use that to get your bearer token. Unlike the existing API clients these clients do not have a Subscription Key, and represent a merchant not a sales unit. To get your bearer token use [Specialized Authentication](https://developer.vippsmobilepay.com/docs/APIs/access-token-api/specialized-authentication.md).

If you already have integrated based on a Recurring API client, it will still work, but we recommend moving to the merchant level client once you have been approved for the Donations product.

See [API guide: Integrations steps](https://developer.vippsmobilepay.com/docs/APIs/donations-api/api-guide.md#integration-steps) for more details.

## October 2025

### Batch limits for payment reports

Reduced the max amount of payments in a single response from the `/donations/v1/reports/payments` endpoint to 1000. This value is subject to change and integrations should account for it being dynamic. This change is done to ensure system stability.
This means that responses may not contain all payments within a given time interval, requiring pagination using the latest `capturedAt` timestamp from each response. Read more in the [API guide best practices section](https://developer.vippsmobilepay.com/docs/APIs/donations-api/api-guide.md#payments-report-best-practices).

## JUNE 2025

Added `transactionReference` to the response for `/donations/v1/reports/payments`.
This field matches the reference field of the Report API and downloadable reports in the portal.

Added `recipientHandles` as query parameter for the `/donations/v1/reports/payments` endpoint. This allows filtering the `recipientHandles`.

## MAY 2025

### Renamed fields in the `/donations/v1/reports/payments` endpoint

Deprecated the `fromDateTimeUtc` and `toDateTimeUtc` query parameters, new ones are named `from` and `to`.

Deprecated the `fromDateTimeUtc` and `toDateTimeUtc` fields in the response, new ones are named `from` and `to`.

Deprecated the `paymentDateTimeUtc` field in the response object, new one is called `capturedAt`.

## APRIL 2025

Made first version of the `/donations/v1/reports/payments` endpoint available.

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).