/
Update a payout request b...

Update a payout request batch
Experimental

Request

Partially updates a payout request batch with a specified ID. Use this operation to update the description and allocation order.

Security
SecretApiKey or JWT
Path
idstring, <= 50 characters^[@~\-\.\w]+$required

ID of the resource.

Bodyapplication/json

Fields for updating the payout request batch. At least one property must be present. Do not set description or allocationOrder to null.

descriptionstring, <= 255 characters

Description of the batch. Omit this property when not updating the description. Do not send null; use a string value when this property is present.

allocationOrderArray of strings, [ 2 .. 25 ] items, unique

Order for auto-allocation of payout requests in this batch. When set, this field overrides the organization-level allocation order during batch auto-allocation. Must contain selected-payment-instrument exactly once. Valid values: payment-card (payment cards), alternative-payment-methods (catch-all for alternative payment methods), selected-payment-instrument (customer-requested instrument), or any payment method API name (for example, paypal, Interac-eTransfer). Omit this property when not updating the allocation order. Do not send null; use an array value when this property is present.

Example:
[
  "paypal",
  "Interac-eTransfer",
  "payment-card",
  "alternative-payment-methods",
  "selected-payment-instrument"
]
curl -i -X PATCH \
  'https://www.rebilly.com/_mock/catalog/all/payout-request-batches/{id}' \
  -H 'Content-Type: application/json' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE' \
  -d '{
    "description": "string",
    "allocationOrder": [
      "paypal",
      "Interac-eTransfer",
      "payment-card",
      "alternative-payment-methods",
      "selected-payment-instrument"
    ]
  }'

Responses

Payout request batch updated.

Headers
X-RateLimit-Limitinteger

Total number of rate limit tokens for this request within a rate limit period. For more information, see Rate limits.

Example:3600
X-RateLimit-Remaininginteger

Remaining number of rate limit tokens for this request within the rate limit period. For example, in the sandbox environment, rate limits for non-GET endpoints are set at 3000 requests per 10 minutes.

Example:3600
Bodyapplication/json
idstring, <= 50 charactersread-only

ID of the batch.

Example:"preq_batch_0YVDMDE2BMC6KBB5MX76RF6T80"
userIdstring, <= 50 charactersread-only

ID of the user who created the batch.

Example:"usr_0YVCEENYJ3D7Q9EN6BN16HA0G4"
totalCountinteger, >= 0read-only

Total number of payout requests in the batch.

Example:10
customerCountinteger, >= 0read-only

Number of unique customers in the batch.

Example:3
totalAmountByCurrencyArray of objectsread-only

Total payout amount grouped by currency in the batch.

descriptionstring or null, <= 255 characters

Optional description of the batch.

Example:"Batch processed on 2024-01-15"
allocationOrderArray of strings or null, [ 2 .. 25 ] items, unique

Order for auto-allocation of payout requests in this batch. When set, this field overrides the organization-level allocation order during batch auto-allocation. Must contain selected-payment-instrument exactly once. Valid values: payment-card (payment cards), alternative-payment-methods (catch-all for alternative payment methods), selected-payment-instrument (customer-requested instrument), or any payment method API name (for example, paypal, Interac-eTransfer).

Example:
[
  "paypal",
  "Interac-eTransfer",
  "payment-card",
  "alternative-payment-methods",
  "selected-payment-instrument"
]
createdTimestring, (date-time)(CreatedTime)read-only

Date and time when the batch was created.

updatedTimestring, (date-time)(UpdatedTime)read-only

Date and time when the batch was last updated.

Response
{
  "id": "preq_batch_0YVDMDE2BMC6KBB5MX76RF6T80",
  "userId": "usr_0YVCEENYJ3D7Q9EN6BN16HA0G4",
  "totalCount": 10,
  "customerCount": 3,
  "totalAmountByCurrency": [
    { … }
  ],
  "description": "Batch processed on 2024-01-15",
  "allocationOrder": [
    "paypal",
    "Interac-eTransfer",
    "payment-card",
    "alternative-payment-methods",
    "selected-payment-instrument"
  ],
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "_links": [
    { … }
  ]
}