{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Partners collect the payment (VCC flow)","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"partners-collect-the-payment-vcc-flow","__idx":0},"children":["Partners collect the payment (VCC flow)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this guide when you support the Online Travel Service scenario, where you charge the traveller and pay Booking.com using a Virtual Credit Card (VCC)."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"is-this-for-you","__idx":1},"children":["Is this for you?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["authorised to directly charge travellers"]}," (merchant of record), and your agreement allows online payments and Virtual Credit Cards usage, this scenario applies to you."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"50px"}},"children":[]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Partner type"},"children":["Partner type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"150px"}},"children":[" Payment method"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/agreement.4bd022a2552e594da434c5b38fa7e0df2c1ff59da8caecf5b10e0eaf8e16beec.fe580a34.svg","alt":"partner1"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partner with Booking.com online payment agreement."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ Virtual Credit Card (VCC)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these instructions and recommendations to create the payment data needed for your requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-case","__idx":2},"children":["Use case"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["A traveller books an accommodation product through your platform. You charge the traveller using your own payment flow, and you pay Booking.com using a VCC."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pre-requisites","__idx":3},"children":["Pre-requisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This payment method is recommended for partners across all regions that meet the following pre-requisites:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"35px"}},"children":["Requirement"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You have a Booking.com payment agreement that allows ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["online payments"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You act as an Online Travel Service and charge the traveller directly."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can generate and fund ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Virtual Credit Cards (VCCs) via your Payment Service Provider (PSP)"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You are using a Demand API version that supports payment timings + VCC (minimum v2.9)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After confirming you meet all the pre-requisites follow these steps:"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Integration steps"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call the /orders/preview and read ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general_policies.payment"]}," to determine:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Available payment timings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Required payment methods."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment schedules (dates)."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create the order with orders/create including the correct details:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["VCC\" as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.method"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The selected ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["and needed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.authentication"]}," data."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-check-payment-options","__idx":4},"children":["1. Check payment options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ Use the orders/preview endpoint to determine:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allowed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.method"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supported card types (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---pay_online_now","__idx":5},"children":["Example - pay_online_now"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Look at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.accommodation.general_policies.payment"]}," in orders/preview response to identify payment timing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example response for pay_online_now:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{3-6}","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation\": {\n    \"general_policies\": {\n      \"payment\": {\n        \"pay_online_now\": {\n          \"method_required\": true,\n          \"dates\": [\n            {\n              \"at\": \"2026-11-18\",\n              \"price\": {\n                \"accommodation_currency\": 200.64,\n                \"booker_currency\": 200.64\n              }\n            },\n            {\n              \"at\": \"2026-12-03\",\n              \"price\": {\n                \"accommodation_currency\": 5.14,\n                \"booker_currency\": 5.14\n              }\n            }\n          ],\n          \"methods\": {\n            \"cards\": [1, 2, 3, 4, ...]\n          }\n        }\n      }\n    }\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---pay_online_later","__idx":6},"children":["Example - pay_online_later"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Look at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.accommodation.general_policies.payment.pay_online_later"]}," in response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the selected property and product the response retrieves:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{5-6}","header":{"controls":{"copy":{}}},"source":"{\n  \"accommodation\": {\n    \"general_policies\": {\n      \"payment\": {\n        \"pay_online_later\": {\n          \"method_required\": true,\n          \"dates\": [\n            {\n              \"at\": \"2026-11-18\",\n              \"price\": {\n                \"accommodation_currency\": 0.00,\n                \"booker_currency\": 0.00\n              }\n            },\n            {\n              \"at\": \"2026-12-01\",\n              \"price\": {\n                \"accommodation_currency\": 200.64,\n                \"booker_currency\": 200.64\n              }\n            },\n            {\n              \"at\": \"2026-12-03\",\n              \"price\": {\n                \"accommodation_currency\": 5.14,\n                \"booker_currency\": 5.14\n              }\n            }\n          ],\n          \"methods\": {\n            \"cards\": [1, 2, 3, 4, ...]\n          }\n        }\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-to-interpret-orderspreview-responses","__idx":7},"children":["How to interpret orders/preview responses"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method_required = true"]}," → You must provide a payment method in /orders/create."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]}," → Those are the allowed card brand IDs. Your VCC must match one of them."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dates"]}," → Instalment schedule. The dates identify how and when the total price of the booking must be paid."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}," - It contains ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["two payment schedule items"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_later"]}," - ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["three payment schedule items"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings/#payment-schedules"},"children":["Payment timing-schedules"]}," more details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/cards"},"children":["common/payments/cards"]}," endpoint to know which cards are identified with these numbers."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-your-order-using-virtual-credit-card-vcc","__idx":8},"children":["2. Create your order using Virtual credit card (VCC)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, when paying online on behalf of the traveller using the Virtual Credit Card (VCC) you must include in the orders/create request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.method"]}," → must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.timing"]}," → must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pay_online_now\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pay_online_later\""]}," (see examples)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.authentication.sca_exemption "]},"→ use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["virtual"]}," for VCC payments."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card details must be: valid, funded, of a supported card type from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardholder"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiry_date"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtype"]}," (v3.2): Use it only if using cards that belong to supported special or co-branded programmes such as UnionPay. (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/models/booking-collects#co-branded-cards---card-subtype"},"children":["More details here"]},")"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_receipt"]}," → Optionally include the receipt in the order response (only available for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}," orders)."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For this case do not use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airplus"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business information"]}," fields."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay_online_now","__idx":9},"children":["Pay_online_now"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow","__idx":10},"children":["The flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/vccpayment.3bd16d75e1413d393a3c8ba2f0f1f119aa45c62e728141101badca9291910c9b.fe580a34.png","alt":"drawing"},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller pays on your platform."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You generate a VCC."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges the VCC according to the schedule."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com pays the property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example---orderscreate-request","__idx":11},"children":["Example - orders/create request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{5,15}","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"card\": {\n      \"authentication\": {\n        \"sca_exemption\": \"virtual\"\n      },\n      \"cardholder\": \"xxxx\",\n      \"cvc\": 123,\n      \"expiry_date\": \"2030-10\",\n      \"number\": \"1234123412341234\"\n      \"subtype\": \"unionpay_cobrand\"\n    },\n    \"include_receipt\": true,\n    \"method\": \"card\",\n    \"timing\": \"pay_online_now\"\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pay_online_later","__idx":12},"children":["Pay_online_later"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow-1","__idx":13},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller books now providing card details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You secure payment responsibility."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges your VCC later (based on schedule)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com pays the property."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To prevent any payment charge issues, ensure that the VCC has sufficient funds at least 2 days prior to the pay-later collection date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example---orderscreate-request-1","__idx":14},"children":["Example - orders/create request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your request must be similar to:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{5,15}","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"card\": {\n      \"authentication\": {\n        \"sca_exemption\": \"virtual\"\n      },\n      \"cardholder\": \"xxxx\",\n      \"cvc\": 123,\n      \"expiry_date\": \"2030-10\",\n      \"number\": \"1234123412341234\"\n      \"subtype\": \"unionpay_cobrand\"\n    },\n    \"include_receipt\": true,\n    \"method\": \"card\",\n    \"timing\": \"pay_online_later\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Curious to know more?"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For more tips and examples on how to preview and create an order, check the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Orders section"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/open-api/demand-api/commonpayments/common/payments/cards"},"children":["common/payments/cards"]}," endpoint to understand the card IDs retrieved in your response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Learn more about payment dates in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/demand/docs/payments/payments-timings/#payment-schedules"},"children":["schedules"]}," section."]}]}]}]},"headings":[{"value":"Partners collect the payment (VCC flow)","id":"partners-collect-the-payment-vcc-flow","depth":1},{"value":"Is this for you?","id":"is-this-for-you","depth":2},{"value":"Use case","id":"use-case","depth":2},{"value":"Pre-requisites","id":"pre-requisites","depth":2},{"value":"1. Check payment options","id":"1-check-payment-options","depth":2},{"value":"Example - pay_online_now","id":"example---pay_online_now","depth":3},{"value":"Example - pay_online_later","id":"example---pay_online_later","depth":3},{"value":"How to interpret orders/preview responses","id":"how-to-interpret-orderspreview-responses","depth":3},{"value":"2. Create your order using Virtual credit card (VCC)","id":"2-create-your-order-using-virtual-credit-card-vcc","depth":2},{"value":"Pay_online_now","id":"pay_online_now","depth":3},{"value":"The flow","id":"the-flow","depth":4},{"value":"Example - orders/create request","id":"example---orderscreate-request","depth":4},{"value":"Pay_online_later","id":"pay_online_later","depth":3},{"value":"The flow","id":"the-flow-1","depth":4},{"value":"Example - orders/create request","id":"example---orderscreate-request-1","depth":4}],"frontmatter":{"seo":{"title":"Partners collect the payment (VCC flow)"}},"lastModified":"2026-05-22T10:56:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/models/partner-collects","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}