---
title: "Update the distribution details of payment requests"
method: PUT
path: "/payment_requests/distribution"
tags: ["Payment requests"]
---

# Update the distribution details of payment requests

`PUT /payment_requests/distribution`

## Request body

- UpdateDistributionDetailsRequest — Request for updating the distribution details for a list of payment requests
  - `paymentRequestIds` string[] — The IDs of the payment requests for which to update the distribution details
  - `distributionDetails` CollectionDetails — Information about how an invoice or payment request is distributed and collected. This defines: - The method by which payment is expected to be collected. - The workflow template used to send the invoice or payment request. - Optional custom message for the customer. - Approval status for automatically distributing to the customer.
    - `collectionMethod` 'AUTO_COLLECT' | 'ON_DEMAND' | 'NONE' — How the payment is expected to be collected. For example: - `AUTO_COLLECT`: Collected automatically via direct debit. Takes effect once the customer has an active direct debit mandate; until they sign, collection waits with status reason `PENDING_DD_MANDATE`. - `ON_DEMAND`: Collected via other payment methods (eg. `CARD`, `APPLE_PAY`, `GOOGLE_PAY`, `BANK`). - `NONE`: No payment collection is initiated automatically.
    - `templateId` string, uuid — The workflow template ID used for sending the invoice or payment request to the customer. Optional — if null, the system default template will be used.
    - `customMessage` string — An optional message that will be sent to the customer when the invoice or payment request is distributed. Can be used for personalized greetings or additional instructions.
    - `approvedForSending` boolean, required — Boolean flag specifying whether the invoice or payment request is approved for sending. Defaults to `true` if not explicitly set.

## Response `200`

The distribution details were updated

## Other responses

- `400` — A problem reading or understanding the request. Ensure that the request complies with the required format and includes all necessary parameters.
- `500` — The server could not process the request.

---

[API](https://skmtc.dev/adfin/apis/adfin-api.md) · [All operations](https://skmtc.dev/adfin/apis/adfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adfin/adfin-api/revisions/53d29f0850e0/schema)