# Update the distribution details of payment requests

Endpoint: PUT /payment_requests/distribution
Version: 1.0.0
Security: Biller Access Token (Staging), Biller Access Token (Production)

## Request fields (application/json):

  - `paymentRequestIds` (array)
    The IDs of the payment requests for which to update the distribution details

  - `distributionDetails` (object)
    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.
    Example: {"collectionMethod":"AUTO_COLLECT","templateId":"d290f1ee-6c54-4b01-90e6-d701748f0851","customMessage":"Thank you for your business!","approvedForSending":true}

  - `distributionDetails.collectionMethod` (string)
    How the payment is expected to be collected.
For example:
- AUTO_COLLECT: Collected automatically via direct debit.
- ON_DEMAND: Collected via other payment methods (eg. CARD, APPLE_PAY, GOOGLE_PAY, BANK).
- NONE: No payment collection is initiated automatically.
. 
Possible values (non-exclusive): AUTO_COLLECT, ON_DEMAND, NONE
    Example: "AUTO_COLLECT"

  - `distributionDetails.templateId` (string)
    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.
    Example: "d290f1ee-6c54-4b01-90e6-d701748f0851"

  - `distributionDetails.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.
    Example: "Thank you for your business!"

  - `distributionDetails.approvedForSending` (boolean, required)
    Boolean flag specifying whether the invoice or payment request is approved for sending.
Defaults to true if not explicitly set.
    Example: true


## Response 200 fields

## Response 400 fields

## Response 500 fields