{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-demand/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"Booking.com collects payment","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":"bookingcom-collects-payment","__idx":0},"children":["Booking.com collects payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Learn how to define the required payment data when creating an order using different credit cards and supported authorisation methods."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"is-this-use-case-for-you","__idx":1},"children":["Is this use case for you?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not authorised to directly charge travellers"]}," (not the merchant of record), but your agreement allows online payments, this scenario applies to you."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this setup:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges the traveller’s credit card."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You securely forward payment data via Demand API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property receives the payout from Booking.com."]}]},{"$$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":"100px"}},"children":[]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{},"children":["Partner type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"style":{"width":"250px"}},"children":[" Online available methods"]}]}]}]},{"$$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/partner.abc227ef8d70c3f1f6816bcd3fd01b4c39c786f23b356fa1703ffaeb2b49c6c3.fe580a34.svg","alt":"partner"},"children":[]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partners not authorised to directly charge travellers.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Booking.com is the merchant of record."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✓ Credit Card + SCA ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ✓ Credit Card (non SCA)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ✓ Credit Card (non SCA) + Riskified ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"✓ Credit card + MOTO"]}]}]}]}]},{"$$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 accommodation in your app and pays online with a credit card."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-flow","__idx":3},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller enters card details in your application."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You send card payment data via orders/create endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges the card."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com pays the property."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/example-pay-online-with-credit-card-2.12b3c11dc67c6770a840e9cf9c4aa2ad12ff4aba08715fa5bb6d5b5e3ae7cad8.fe580a34.png","alt":"drawing"},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This option is available only if your partner agreement with Booking.com includes Online payments. Check the prerequisites for your authentication method before implementation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Implementation steps:"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/preview"},"children":["/orders/preview endpoint"]}," to check supported card methods and timings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provide payment details including the correct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.authentication method"]}," in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]}," request."]}]}]},{"$$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":"li","attributes":{},"children":["Whether SCA / Riskified / exemptions are supported."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Payments quick guide"]}," for details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the common/payments/cards endpoint to understand the card IDs retrieved in your response."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-your-order","__idx":5},"children":["2. Create your order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["→ Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using cards, your request must include the correct ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.authentication"]},", according to your business regional legislation (e.g. SCA in the EEA)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example---generic-card-payment-object","__idx":6},"children":["Example - Generic card payment object"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In general, when using cards as the payment method, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment"]}," field in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/open-api/demand-api/orders/orders/create"},"children":["/orders/create"]}," request should look like this:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"3.1 request ","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"card\": {\n      \"authentication\": {\n        \"riskified\": {...}, // only if needed\n        \"sca_exemption\": \"moto\", // only if needed\n        \"3d_secure\": {\n          \"authentication_value\": \"xxxx\",\n          \"eci\": \"xxxx\",\n          \"transaction\": \"xxxx\"\n        }\n      },\n      \"cardholder\": \"xxxx\",\n      \"cvc\": \"123\",\n      \"expiry_date\": \"2030-10\",\n      \"number\": \"1234123412341234\"\n    },\n    \"include_receipt\": true,\n    \"method\": \"card\",\n    \"timing\": \"pay_online_now\"\n  }\n}\n\n\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"3.2 request","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This version of the API includes additional fields such as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.subtype"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure.authentication_response"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payment\": {\n    \"card\": {\n      \"authentication\": {\n        \"riskified\": {...}, // only if needed\n        \"sca_exemption\": \"moto\", // only if needed\n        \"3d_secure\": {\n          \"authentication_value\": \"AAABBIIFmAAAAAAAAAAAAAAAAAA=\",\n          \"eci\": \"05\",\n          \"transaction\": \"3ds_txn_789\"\n          \"authentication_response\": \"Y\"\n        }\n      },\n      \"cardholder\": \"Jane Doe\",\n      \"cvc\": \"123\",\n      \"expiry_date\": \"2030-10\",\n      \"number\": \"4111111111111111\",\n      \"subtype\": \"unionpay_cobrand\" // only if needed\n    },\n    \"include_receipt\": true,\n    \"method\": \"card\",\n    \"timing\": \"pay_online_now\"\n  }\n}\n\n","lang":"json"},"children":[]}]}]},{"$$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":"150px"}},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.authentication"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only include when required (SCA, Riskified, or MOTO exemption):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SCA (3D Secure) cards"]}," – Provide the SCA token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure"]}," object."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Riskified (non-SCA)"]}," – Provide Riskified authentication data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MOTO (SCA exempted)"]}," - Indicate exemption using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sca_exemption"]}," field (e.g., \"moto\")."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required for card payments. No authentication needed if the card is non-SCA and not using Riskified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","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"]}," (and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtype"]}," in v3.2)."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Must be valid card details. Ensure the card type is listed in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methods.cards"]}," array returned by the /orders/preview response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["(See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/how-to"},"children":["Quick guide"]}," to learn how to get this information)."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_receipt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional. Set to true if you want the payment receipt returned in the response (only available for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]}," orders)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," for card payments."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For online payments, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay_online_now"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do not include"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airplus"]}," or any business-related fields for this payment type."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"credit-card--sca-token-3d-secure","__idx":7},"children":["Credit Card + SCA token (3D Secure)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For transactions that require ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Strong Customer Authentication (SCA)"]}," under European Economic Area (EEA) regulations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow-1","__idx":8},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller performs SCA on your platform, providing their card details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You receive a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3DS token"]}," from your Payment Service Provider (PSP)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment initiation - You send the traveller's card SCA Token using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure"]}," object (or empty if frictionless).",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["3DS challenge - If the ACS requires a challenge, the client collects ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]},", and optionally ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_response"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Order creation - Include the completed 3DS data in the /orders/create request."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Processing - The payment gateway validates the 3DS data before authorising the payment."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges the card and pays the property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"pre-requisites","__idx":9},"children":["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":["Checklist"]}]}]}]},{"$$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 work with a Payment Service Provider (PSP) that supports SCA token generation (and able to share SCA version 1 or 2 with Booking.com)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You receive SCA values from PSP."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Online Payments + SCA addendum signed."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"3d-secure-3ds-authentication","__idx":10},"children":["3D Secure (3DS) Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure"]}," object contains ontains the authentication results from your 3D Secure provider for a card payment."," ","You must include these values to confirm that the cardholder authentication step was completed."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For this case ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["do not use"]}," the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskified"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sca_exemption"]}," fields."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Object structure"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your /orders/create request, populate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.authentication.3d_secure"]}," with the values returned by your 3DS provider."]},{"$$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":"170px"}},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Cardholder Authentication Verification Value (CAVV) returned by the 3DS Server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirms successful cardholder authentication."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Electronic Commerce Indicator (ECI) returned by the 3DS Server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Indicates the authentication result (e.g., fully authenticated, attempted, or not authenticated)."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅ Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Unique ID assigned by the Directory Server (DS) for this 3DS transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Used for traceability and reconciliation."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_response"]}," (v3.2)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌ Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The 3D Secure transaction status (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transStatus"]},") returned by your 3DS provider."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For frictionless flows, provide the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transStatus"]}," from the Authentication response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Not required if no challenge occurred."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtain these values from your bank or Payment Service Provider (PSP)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Usage example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"payment\": {\n  \"card\": {\n    \"authentication\": {\n      \"3d_secure\": {\n        \"authentication_value\": \"AAABBBCCC123=\",\n        \"eci\": \"05\",\n        \"transaction\": \"abc123xyz\",\n        \"authentication_response\": \"Y\"\n      }\n    }\n  }\n}\n\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explanation:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]}," - token returned after the cardholder completes 3DS authentication."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]}," - indicates that the cardholder was fully authenticated."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]}," - uniquely identifies this authentication attempt."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_response"]}," - confirms the transaction status (success in this example)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication response (v3.2)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are using Demand API v3.2, you can optionally send \"authentication_response\". This field maps to the 3DS transStatus value returned by your provider."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The available values follow the transStatus codes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Y – Authentication successful."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["N – Authentication failed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["U – Unable to authenticate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A – Attempted authentication (for frictionless flows)."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only send this field if your provider returns it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"best-practices","__idx":11},"children":["Best practices"]},{"$$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":"150px"}},"children":["Field / Area"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Why / Note"},"children":["Why / Note"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_response"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include only if a 3DS challenge flow occurred or your 3DS provider returns it."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Frictionless flows may omit this field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid sending empty or unnecessary data."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always provide these fields for 3DS-required payments."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing any of these will cause payment failures."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not leave blank."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treat as sensitive: never log in plain text or expose in URLs."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Protect customer data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Security compliance."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_value"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eci"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication_response"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use consistent casing and terminology exactly as specified."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Avoid developer confusion and integration errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consistency matters."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integrating multiple 3DS providers"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map each provider’s output to these standard fields."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensures uniform behaviour and reduces bugs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Standardise outputs."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"credit-card-non-sca","__idx":12},"children":["Credit card (non SCA)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For transactions where fraud checks are handled by your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["own fraud provider"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow-2","__idx":13},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller provides card details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fraud protection is handled externally."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You forward the traveller`s credit card details to Booking.com, with no token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com pays the property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"pre-requisites-1","__idx":14},"children":["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":["Checklist"]}]}]}]},{"$$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 Fraud risk prevention provider."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Demand API must be updated minimum to version 2.10."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"define-your-request","__idx":15},"children":["Define your request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the card details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"payment\": {\n  \"card\": {\n    \"cardholder\": \"xxxx\",\n    \"cvc\": 123,\n    \"expiry_date\": \"2030-10\",\n    \"number\": \"1234123412341234\"\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For this case ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do not use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.authentication"]}," field"]}," in your request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"co-branded-cards---card-subtype","__idx":16},"children":["Co-branded cards - card subtype"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are using Demand API v3.2 you should provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.subtype"]}," when submitting cards that belong to supported special or co-branded programmes, currently to UnionPay co-branded cards:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UnionPay + Visa."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UnionPay + Mastercard."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["These cards use Visa or Mastercard number ranges."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Network cannot be reliably inferred from PAN alone."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{8}","header":{"controls":{"copy":{}}},"source":"\"payment\": {\n  \"method\": \"card\",\n  \"card\": {\n    \"cardholder\": \"xxxx\",\n    \"cvc\": 123,\n    \"expiry_date\": \"2030-10\",\n    \"number\": \"1234123412341234\"\n    \"subtype\": \"unionpay_cobrand\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Even though the number appears to be Visa-range, the subtype ensures correct routing as UnionPay co-brand."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the field is omitted, the system will assume a standard card programme and route based only on the detected network from the card number."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important notes:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Detection Responsibility"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your integration is responsible for setting ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtype"]}," when you know the card belongs to a supported special programme. This is typically determined by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["BIN tables."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upstream payment SDK metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Issuer identification data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gateway hints."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Do not provide subtype for:"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✗ Standard Visa cards.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✗ Standard Mastercard cards.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✗ Standard UnionPay cards (pure UnionPay range)",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✗ Debit/credit classification differences.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","✗ Corporate vs consumer cards.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This field is not a funding type or product category indicator."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"credit-card-non-sca--riskified","__idx":17},"children":["Credit Card (non SCA) + Riskified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For partners using ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.riskified.com/","target":"_blank"},"children":["Riskified"]}," to provide fraud detection."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-flow-3","__idx":18},"children":["The flow"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Traveller provides card details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.riskified.com/","target":"_blank"},"children":["Riskified"]}," validates the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You send card details ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["plus Riskified session ID and IP address"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Booking.com charges the traveller credit card and pays the property."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"pre-requisites-2","__idx":19},"children":["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":["Checklist"]}]}]}]},{"$$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 an integration with Riskified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["☑"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Demand API version must be updated minimum to version 2.10."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"create-your-order-request","__idx":20},"children":["Create your order request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.card.authentication.riskified"]}," field:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskified.session_id"]}," - Must contain your Riskified-provided session ID for external fraud verification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ip_address"]}," - This is a mandatory field."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sca_exemption"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3d_secure"]}," fields in this scenario."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-highlight":"{9-11}","header":{"controls":{"copy":{}}},"source":"\"payment\": {\n  \"include_receipt\": false,\n  \"card\": {\n    \"number\": \"4111111111111111\",\n    \"expiry_date\": \"2030-03\",\n    \"cardholder\": \"io\",\n    \"cvc\": \"xxx\",\n    \"authentication\": {\n      \"riskified\": {\n        \"session_id\": \"00000000-0000-0000-0000-000000000000\",\n        \"ip_address\": \"127.0.0.1\"\n      }\n    }\n  },\n  \"timing\": \"pay_online_now\",\n  \"method\": \"card\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mail-ordertelephone-order-moto-sca-exemption","__idx":21},"children":["Mail order/telephone order (MOTO) (SCA exemption)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Corporate partners"]},", where SCA does not apply (telephone or email bookings)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/models/corporate#using-credit-card--moto"},"children":["Corporate partners use case"]}," for details."]},{"$$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":["Learn more about the credit card method in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/payments-methods#credit-cards"},"children":["Payment methods"]}," section."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow detailed guidance for MOTO transactions in the  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/payments/models/corporate/"},"children":["Corporate partners use case"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/demand/docs/orders-api/order-preview-create"},"children":["Orders section"]}," for tips and examples on how to preview and create your order requests."]}]}]}]},"headings":[{"value":"Booking.com collects payment","id":"bookingcom-collects-payment","depth":1},{"value":"Is this use case for you?","id":"is-this-use-case-for-you","depth":2},{"value":"Use case","id":"use-case","depth":2},{"value":"The flow","id":"the-flow","depth":3},{"value":"1. Check payment options","id":"1-check-payment-options","depth":2},{"value":"2. Create your order","id":"2-create-your-order","depth":2},{"value":"Example - Generic card payment object","id":"example---generic-card-payment-object","depth":3},{"value":"Credit Card + SCA token (3D Secure)","id":"credit-card--sca-token-3d-secure","depth":3},{"value":"The flow","id":"the-flow-1","depth":4},{"value":"Pre-requisites","id":"pre-requisites","depth":4},{"value":"3D Secure (3DS) Authentication","id":"3d-secure-3ds-authentication","depth":4},{"value":"Best practices","id":"best-practices","depth":4},{"value":"Credit card (non SCA)","id":"credit-card-non-sca","depth":3},{"value":"The flow","id":"the-flow-2","depth":4},{"value":"Pre-requisites","id":"pre-requisites-1","depth":4},{"value":"Define your request","id":"define-your-request","depth":4},{"value":"Co-branded cards - card subtype","id":"co-branded-cards---card-subtype","depth":3},{"value":"Credit Card (non SCA) + Riskified","id":"credit-card-non-sca--riskified","depth":3},{"value":"The flow","id":"the-flow-3","depth":4},{"value":"Pre-requisites:","id":"pre-requisites-2","depth":4},{"value":"Create your order request","id":"create-your-order-request","depth":4},{"value":"Mail order/telephone order (MOTO) (SCA exemption)","id":"mail-ordertelephone-order-moto-sca-exemption","depth":3}],"frontmatter":{"title":"No direct charge to travellers","description":"Learn how to create orders when you are not authorised to directly charge travellers. Covers card payments, SCA (3DS), Riskified, MOTO exemptions, and required payment.card.authentication data in the Demand API.","tags":["demand-api","payments","orders","card-payments","sca","3ds","riskified","moto"],"api":["/orders/preview","/orders/create"],"keywords":["Booking.com Demand API payments","card payment integration","3D Secure authentication","SCA card payments","orders create payment","Riskified payments","MOTO exemption"],"x-redocly":{"seo":{"title":"Booking.com Demand API — card payments without direct traveller charge","description":"Integration guide for partners who are not the merchant of record. Learn how to send card payment data, SCA (3DS) results, Riskified data, and exemptions using the Demand API orders endpoints."},"audience":["developer","partners","business"],"apiVersion":"v3.1, v3.2","product":"orders"},"seo":{"title":"Booking.com collects payment"}},"lastModified":"2026-05-22T10:56:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/demand/docs/payments/models/booking-collects","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}