Contents

POST [/instances/$INSTANCE]/private/donau#

Link a new Donau charity instance to $INSTANCE. The backend fetches and validates the charity’s metadata from the given Donau service before persisting the link.

Required permission: donau-write

Request:

The body must be a PostDonauRequest.

interface PostDonauRequest {
  // Base URL of the Donau service hosting the charity
  donau_url: string;

  // Numeric charity identifier inside the Donau service
  charity_id: Integer;
}

Response:

204 No content:

The charity link was created successfully.

202 Accepted:

Operation requires MFA; a ChallengeResponse is returned. @since v21

400 Bad request:

Malformed JSON or missing fields.

409 Conflict:

  • The charity is already linked with different parameters, or

  • The charity’s public key does not match the merchant instance’s public key.

502 Bad gateway:

Communication with the Donau service failed.

Contents