Retrieve payment and payout details for accommodation reservations, including partner payout information, breakdowns, bank transfer details, and VCC management.
Payments API (1.0)
Download OpenAPI description
Overview
URLConnectivity Team
Languages
Servers
Test static response
https://developers.booking.com/_mock/connectivity/docs/openapispecs/payments-api/payments-api-specification
Test using live endpoint
https://payments-api.booking.com
Learn how to effectively use the Try it feature in the Payments API documentation.
Use the Try it feature to send test request examples to the API endpoints directly from the developer portal and depending on the selected environment either see static, pre-built responses or dynamic responses from a test property.
Using the UI, toggle between Edit and Preview tabs to see the values applied to the path or query placeholders (if there are any). You can also click on any unresolved placeholders to add a value or edit an existing placeholder value.
The portal loads the default request body. Where the specification supports multiple request body examples (for example: Rooms API POST endpoint), you can choose a different request body from the drop-down list.
Some helpful pointers before running a request:
Authentication (when using live endpoint): Configure your authentication headers
- API Key or OAuth token as required. Use the Environments tab.
- Make sure to manage separate machine accounts for test vs. properties in production.
- Ensure credentials match your selected environment.
Parameters: Fill in required parameters
- Path parameters (like
reservation-id)
- Path parameters (like
Execute: Click Send to send the request
- The request is sent to the selected environment
- When sending requests to the live endpoint, the response will be a real response from the API.
After executing a request, you will see:
- Status code: HTTP response status
- Response body: JSON response data
- Headers: Response headers