---
title: "Update Payments by Booking configurations"
method: POST
path: "/connectivity-payments/pbb/configurations"
tags: ["Payments by Booking configurations"]
---

# Update Payments by Booking configurations

`POST /connectivity-payments/pbb/configurations`

Updates Payments by Booking configurations and returns processing status

## Headers

- `accept-version` string

## Request body

- PBBConfigurationUpdateRequest
  - `payout_configurations` PayoutConfiguration[]
    - `legal_entity_id` string, required
    - `property_ids` integer[], required — <=10 property IDs per request. All `property_ids` in a request should belong to a common legal entity ID.
    - `payout_method` string, required — The method by which Booking.com remits payments to the partner for this property. Possible values: VCC, BT, STRIPE.
    - `payout_netting` string, required — Defines how commissions or payment-related costs are deducted directly from each payout. Possible values: GROSS, NET.
    - `payout_frequency` string, nullable — How often payouts should be executed to the partner for this property. Applies mainly when payout_method is 'BT'. Possible values: DAILY, WEEKLY, MONTHLY. Set to null when payout_method is VCC or STRIPE.
    - `payin_collection_strategy` string, required — Payin collection strategy. Possible values: PARTIAL, ALL.

## Response `202`

Request accepted for processing

- PBBConfigurationUpdateStatusResponse — Response of Payments by Booking configurations update request with property-level processing status of accepted configuration change request.
  - `meta` DefaultMeta — Metadata for the response
    - `ruid` string — Request unique identifier
  - `data` PBBConfigurationUpdateStatusDetails — Information regarding Payments by Booking configuration change request for properties
    - `config_update_details` PBBConfigurationUpdateStatusDetail[] — Status information for Payments by Booking configuration change requested for properties
      - `property_id` string — Property identifier
      - `request_id` string, nullable — Idempotency key of the latest accepted Payments by Booking configuration change request. Null when status is REJECTED.
      - `status` string — Payments by Booking configuration change status for property
      - `rejection_reason` string, nullable — Reason for rejection of Payments by Booking configuration change request. Null when request is accepted.
      - `requested_at` string, nullable — Payments by Booking configuration change requested at. Null when status is REJECTED.
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — Invalid request payload.
- `401` — Unauthorized. Missing or invalid authentication token.
- `403` — Access Denied!
- `429` — Rate limit exceeded. Maximum 30 requests per minute.
- `500` — The request failed with an internal server error.

---

[API](https://skmtc.net/booking/apis/payments-by-booking-onboarding-api.md) · [All operations](https://skmtc.net/booking/apis/payments-by-booking-onboarding-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/payments-by-booking-onboarding-api/revisions/16927ccf878d/schema)